> ## 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.

# GetXmaDecodePositionForSample

> GetXmaDecodePositionForSample

# GetXmaDecodePositionForSample

指定された XBOX Media Audio (XMA) ブロックの先頭から相対的な、指定されたサンプル位置からデコーダーがオーディオを生成するために必要なデータを取得します。

## 構文

```cpp theme={null}
HRESULT GetXmaDecodePositionForSample(  
         const BYTE* pXmaData,  
         DWORD nXmaDataBytes,  
         DWORD nStreamIndex,  
         DWORD nDesiredSample,  
         DWORD* pnBitOffset,  
         DWORD* pnSubFrame  
)  
```

### パラメーター

*pXmaData*   \_In\_bytecount\_(nXmaDataBytes)\
型: BYTE\*

XMA ブロックへのポインター。

*nXmaDataBytes*   \
型: DWORD

pXmaData のサイズ (バイト単位)。

*nStreamIndex*   \
型: DWORD

シークするストリーム。

*nDesiredSample*   \
型: DWORD

検索するサンプル。

*pnBitOffset*   \_Out\_\
型: DWORD\*

検索するサンプルを含むフレームの pXmaData 内のビット オフセットを返します。

*pnSubFrame*   \_Out\_\
型: DWORD\*

サンプルを含むサブフレームを返します。

### 戻り値

型: HRESULT

成功時は `S_OK`、エラー時は `E_FAIL` コード。

## 解説

この関数は、指定された XMA ブロックの先頭から相対的な、指定されたサンプル位置からデコーダーがオーディオを生成するために必要なデータを取得します。これには、該当するフレームのビット オフセットと、そのフレーム内の適切なサブフレームが含まれます。データは `XMAPlaybackSetDecodePosition` 関数に直接渡すことができます。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)
- [GetXmaFrameBitPosition](/ja-jp/reference/audio/xma2defs/functions/getxmaframebitposition.md)
- [GetLastXmaFrameBitPosition](/ja-jp/reference/audio/xma2defs/functions/getlastxmaframebitposition.md)
- [GetShapeXmaNumSubframesToDecode](/ja-jp/reference/audio/shapexmacontext/functions/getshapexmanumsubframestodecode.md)
- [SetSamplePositions](/ja-jp/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist1/methods/id3d12graphicscommandlist1_setsamplepositions_public.md)