> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GetXmaBlockContainingSample

> GetXmaBlockContainingSample

# GetXmaBlockContainingSample

지정된 탐색 테이블을 사용하여 지정된 디코딩된 샘플을 포함하는 XBOX Media Audio(XMA) 블록을 찾습니다. XMA 파일의 탐색 테이블 항목은 빅 엔디안 형식으로 저장되며 이 함수를 호출하기 전에 변환이 필요한 경우가 있습니다.

## 구문

```cpp theme={null}
HRESULT GetXmaBlockContainingSample(  
         DWORD nBlockCount,  
         const DWORD* pSeekTable,  
         DWORD nDesiredSample,  
         DWORD* pnBlockContainingSample,  
         DWORD* pnSampleOffsetWithinBlock  
)  
```

### 매개 변수

*nBlockCount*   \
형식: DWORD

파일의 블록 수입니다. 탐색 테이블의 항목 수와 동일합니다.

*pSeekTable*   \_In\_count\_(nBlockCount)\
형식: DWORD\*

탐색 테이블 데이터에 대한 포인터입니다.

*nDesiredSample*   \
형식: DWORD

찾을 디코딩된 샘플입니다.

*pnBlockContainingSample*   \_Out\_\
형식: DWORD\*

샘플을 포함하는 블록의 인덱스입니다.

*pnSampleOffsetWithinBlock*   \_Out\_\
형식: DWORD\*

이 블록 내 샘플의 위치입니다.

### 반환 값

형식: HRESULT

성공하면 `S_OK`, 실패하면 `E_FAIL` 코드입니다.

## 설명

이 함수는 `pSeekTable` 포인터를 사용하여 지정된 디코딩된 샘플을 포함하는 XMA 블록을 찾습니다. XMA 파일의 탐색 테이블 항목은 빅 엔디안 형식으로 저장됩니다.

<Note>탐색 테이블 항목은 이 함수를 호출하기 전에 변환이 필요할 수 있습니다.</Note>

XMA2에 대한 자세한 내용은 [XMA2 개요](/build/console-features/audio/overviews/xma2-overview)를 참조하세요. XBOX One의 오디오 아키텍처 개요는 **미래의 사운드**: [XBOX One의 오디오 아키텍처](/build/console-features/audio/overviews/xbox-one-audio-architecture)를 참조하세요.

## 요구 사항

**헤더:** xma2defs.h

**지원 플랫폼:** XBOX One 제품군 콘솔 및 XBOX Series 콘솔

## 관련 항목

[xma2defs](/reference/audio/xma2defs/xma2defs_members)


## Related topics

- [XMA2Defs](/ko/reference/audio/xma2defs/xma2defs_members.md)
- [GetShapeSrcXmaBlocksToSkip](/ko/reference/audio/shapesrccontext/functions/getshapesrcxmablockstoskip.md)
- [GetXmaSampleRate](/ko/reference/audio/xma2defs/functions/getxmasamplerate.md)
- [SetShapeSrcXmaBlocksToSkip](/ko/reference/audio/shapesrccontext/functions/setshapesrcxmablockstoskip.md)
- [GetShapeXmaSampleRate](/ko/reference/audio/shapexmacontext/functions/getshapexmasamplerate.md)