> ## 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](/ja-jp/reference/audio/xma2defs/xma2defs_members.md)
- [GetXmaSampleRate](/ja-jp/reference/audio/xma2defs/functions/getxmasamplerate.md)
- [GetXmaDecodePositionForSample](/ja-jp/reference/audio/xma2defs/functions/getxmadecodepositionforsample.md)
- [GetShapeXmaSampleRate](/ja-jp/reference/audio/shapexmacontext/functions/getshapexmasamplerate.md)
- [SHAPE_XMA_SAMPLE_RATE](/ja-jp/reference/audio/shapexmacontext/enums/shape_xma_sample_rate.md)