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

# GetXmaFrameBitPosition

> GetXmaFrameBitPosition

# GetXmaFrameBitPosition

計算指定框架在 XBOX Media Audio (XMA) 區塊或一組區塊內的位元位移。

## 語法

```cpp theme={null}
DWORD GetXmaFrameBitPosition(  
         const BYTE* pXmaData,  
         DWORD nXmaDataBytes,  
         DWORD nStreamIndex,  
         DWORD nDesiredFrame  
)  
```

### 參數

*pXmaData*   \_In\_bytecount\_(nXmaDataBytes)\
類型：BYTE\*

指向 XMA 區塊的指標。

*nXmaDataBytes*   \
類型：DWORD

pXmaData 的大小 (以位元組為單位)。

*nStreamIndex*   \
類型：DWORD

要在其中搜尋的串流。

*nDesiredFrame*   \
類型：DWORD

要搜尋的框架。

### 傳回值

類型：DWORD

傳回位元位置；失敗時傳回 0。

## 備註

此函式會計算指定框架在 XMA 區塊或一組區塊內的位元位移。失敗時會傳回 0。指向 XMA 區塊的指標使用 `pXmadata` 參數。如需 XBOX One 音訊架構的概觀，請參閱**未來之聲**：[XBOX One 的音訊架構](/zh-TW/build/console-features/audio/overviews/xbox-one-audio-architecture)。

## 需求

**標頭：** xma2defs.h

**支援的平台：** XBOX One 系列主機和 XBOX Series 主機

## 另請參閱

[音訊概觀](/zh-TW/build/console-features/audio/overviews/audio)

[xma2defs](/zh-TW/reference/audio/xma2defs/xma2defs_members)


## Related topics

- [GetXmaFrameBitPosition](/reference/audio/xma2defs/functions/getxmaframebitposition.md)
- [XMA2Defs](/reference/audio/xma2defs/xma2defs_members.md)