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

# SHAPE_PCM_CONTEXT

> SHAPE_PCM_CONTEXT

# SHAPE\_PCM\_CONTEXT

PCM 內容結構。

## 語法

```cpp theme={null}
typedef struct SHAPE_PCM_CONTEXT {
    UINT32 bufferStart : 32;  
    UINT32 bufferLength : 21;  
    UINT32 reserved0 : 11;  
    UINT32 loopCount : 8;  
    UINT32 reserved1 : 8;  
    UINT32 full : 1;  
    UINT32 reserved2 : 15;  
    UINT32 readPointer : 21;  
    UINT32 reserved3 : 11;  
    UINT32 loopStartWritePointer : 21;  
    UINT32 reserved4 : 11;  
    UINT32 loopEnd : 21;  
    UINT32 reserved5 : 11;  
    UINT32 mode : 1;  
    UINT32 reserved6 : 15;  
    UINT32 format : 2;  
    UINT32 reserved7 : 14;  
    UINT32 reserved[1];  
} SHAPE_PCM_CONTEXT  
```

### 成員

*bufferStart*\
類型：UINT32

寫入：音訊緩衝區。

*bufferLength*\
類型：UINT32

寫入：音訊緩衝區的長度 (以樣本為單位)。

*reserved0*\
類型：UINT32

保留。

*loopCount*\
類型：UINT32

讀取/寫入：迴圈計數。

*reserved1*\
類型：UINT32

保留。

*full*\
類型：UINT32

寫入：對於循環緩衝區，當 *readPointer* 與 *loopStartWritePointer* 相同時：1 == 緩衝區已滿，0 == 緩衝區為空。

*reserved2*\
類型：UINT32

保留。

*readPointer*\
類型：UINT32

讀取/寫入：從音訊緩衝區開頭起算、以框架對齊的 128 樣本位移 (以樣本為單位)。較低的七 (7) 個位元會被忽略。

*reserved3*\
類型：UINT32

保留。

*loopStartWritePointer*\
類型：UINT32

寫入：從音訊緩衝區開頭起算、非框架對齊的樣本位移。對於線性緩衝區，表示迴圈起點；對於循環緩衝區，表示寫入指標。

*reserved4*\
類型：UINT32

保留。

*loopEnd*\
類型：UINT32

寫入：從音訊緩衝區開頭起算、非框架對齊的樣本位移。表示迴圈終點。最小迴圈大小為 128 個樣本。

*reserved5*\
類型：UINT32

保留。

*mode*\
類型：UINT32

寫入：SHAPE\_PCM\_MODE

*reserved6*\
類型：UINT32

保留。

*format*\
類型：UINT32

寫入：SHAPE\_PCM\_FORMAT

*reserved7*\
類型：UINT32

保留。

*reserved*\
類型：UINT32\[1]

保留。

## 備註

標示為 **寫入** 的欄位由您的應用程式設定，且不會被音訊控制處理器 (ACP) 程式庫變更。標示為 **讀取/寫入** 的欄位由您的應用程式設定，但可能會被 ACP 程式庫變更。

脈衝編碼調變 (PCM) 緩衝區的大小取決於緩衝區的格式。請參閱 [SHAPE\_PCM\_FORMAT](/zh-TW/reference/audio/shapepcmcontext/enums/shape_pcm_format) 的備註。

## 需求

**標頭：** shapepcmcontext.h

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

## 概念文件

* [ACP 概觀](/zh-TW/build/console-features/audio/overviews/acp-overview)

## 另請參閱

[ACP 概觀](/zh-TW/build/console-features/audio/overviews/acp-overview)\
[Shape 概觀](/zh-TW/build/console-features/audio/overviews/shape-overview)\
[shapepcmcontext](/zh-TW/reference/audio/shapepcmcontext/shapepcmcontext_members)


## Related topics

- [SHAPE_PCM_CONTEXT](/reference/audio/shapepcmcontext/structs/shape_pcm_context.md)
- [ShapePcmContext](/reference/audio/shapepcmcontext/shapepcmcontext_members.md)