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

# ACP_COMMAND_UPDATE_ALL_CONTEXTS

> ACP_COMMAND_UPDATE_ALL_CONTEXTS

# ACP\_COMMAND\_UPDATE\_ALL\_CONTEXTS

用於更新所有可擴充硬體音訊處理引擎 (SHAPE) 內容類型之陣列的命令。

## 語法

```cpp theme={null}
typedef struct ACP_COMMAND_UPDATE_ALL_CONTEXTS {  
    UINT32 srcEntryCount;  
    UINT32 eqCompEntryCount;  
    UINT32 filtVolEntryCount;  
    UINT32 dmaReadEntryCount;  
    UINT32 dmaWriteEntryCount;  
    UINT32 pcmEntryCount;  
    UINT32 xmaEntryCount;  
    APU_ADDRESS srcEntries;  
    APU_ADDRESS eqCompEntries;  
    APU_ADDRESS filtVolEntries;  
    APU_ADDRESS dmaReadEntries;  
    APU_ADDRESS dmaWriteEntries;  
    APU_ADDRESS pcmEntries;  
    APU_ADDRESS xmaEntries;  
    UINT32 srcIndexCount;  
    UINT32 eqCompIndexCount;  
    UINT32 filtVolIndexCount;  
    UINT32 dmaReadIndexCount;  
    UINT32 dmaWriteIndexCount;  
    UINT32 pcmIndexCount;  
    UINT32 xmaIndexCount;  
    APU_ADDRESS srcIndices;  
    APU_ADDRESS eqCompIndices;  
    APU_ADDRESS filtVolIndices;  
    APU_ADDRESS dmaReadIndices;  
    APU_ADDRESS dmaWriteIndices;  
    APU_ADDRESS pcmIndices;  
    APU_ADDRESS xmaIndices;  
} ACP_COMMAND_UPDATE_ALL_CONTEXTS  
```

### 成員

*srcEntryCount*\
類型：UINT32

取樣率轉換器 (SRC) 項目的計數。

*eqCompEntryCount*\
類型：UINT32

EQ/Comp 項目的計數。

*filtVolEntryCount*\
類型：UINT32

Filter/Volume 項目的計數。

*dmaReadEntryCount*\
類型：UINT32

從混音緩衝區讀取之直接記憶體存取 (DMA) 項目的計數。

*dmaWriteEntryCount*\
類型：UINT32

寫入混音緩衝區之 DMA 項目的計數。

*pcmEntryCount*\
類型：UINT32

脈衝碼調變 (PCM) 項目的計數。

*xmaEntryCount*\
類型：UINT32

XBOX Media Audio (XMA) 項目的計數。

*srcEntries*\
類型：APU\_ADDRESS

指向 SRC 項目陣列的指標。

*eqCompEntries*\
類型：APU\_ADDRESS

指向 EQ/Comp 項目陣列的指標。

*filtVolEntries*\
類型：APU\_ADDRESS

指向 Filter/Volume 項目陣列的指標。

*dmaReadEntries*\
類型：APU\_ADDRESS

指向從混音緩衝區讀取之 DMA 項目陣列的指標。

*dmaWriteEntries*\
類型：APU\_ADDRESS

指向寫入混音緩衝區之 DMA 項目陣列的指標。

*pcmEntries*\
類型：APU\_ADDRESS

指向 PCM 項目陣列的指標。

*xmaEntries*\
類型：APU\_ADDRESS

指向 XMA 項目陣列的指標。

*srcIndexCount*\
類型：UINT32

SRC 索引的計數。

*eqCompIndexCount*\
類型：UINT32

EQ/Comp 索引的計數。

*filtVolIndexCount*\
類型：UINT32

Filter/Volume 索引的計數。

*dmaReadIndexCount*\
類型：UINT32

從混音緩衝區讀取之 DMA 索引的計數。

*dmaWriteIndexCount*\
類型：UINT32

寫入混音緩衝區之 DMA 索引的計數。

*pcmIndexCount*\
類型：UINT32

PCM 索引的計數。

*xmaIndexCount*\
類型：UINT32

XMA 索引的計數。

*srcIndices*\
類型：APU\_ADDRESS

指向 SRC 項目的不帶正負號 16 位元索引陣列。

*eqCompIndices*\
類型：APU\_ADDRESS

指向 EQ/Comp 項目的不帶正負號 16 位元索引陣列。

*filtVolIndices*\
類型：APU\_ADDRESS

指向 Filter/Volume 項目的不帶正負號 16 位元索引陣列。

*dmaReadIndices*\
類型：APU\_ADDRESS

指向 DMA 讀取項目的不帶正負號 16 位元索引陣列。

*dmaWriteIndices*\
類型：APU\_ADDRESS

指向 DMA 寫入項目的不帶正負號 16 位元索引陣列。

*pcmIndices*\
類型：APU\_ADDRESS

指向 PCM 項目的不帶正負號 16 位元索引陣列。

*xmaIndices*\
類型：APU\_ADDRESS

指向 XMA 項目的不帶正負號 16 位元索引陣列。

## 備註

執行區塊更新的方法有兩種。

在直接方法中，會使用 *\*EntryCount* 和 *\*Entries* 成員，並忽略索引成員。區塊更新的行為如下。

```cpp theme={null}
    for(i = 0; i < entryCount; ++i)
    {
        UpdateContext(entries[i]);
    } 
```

在間接方法中，會使用 *\*IndexCount* 和 *\*Indices* 成員，並忽略項目成員。區塊更新的行為如下。

```cpp theme={null}
    for(int i = 0; i < indexCount; ++i)
    {
        UpdateContext(entries[indices[i] ]);
    }  
```

若要更新單一內容，請使用 [ACP\_COMMAND\_UPDATE\_CONTEXTS](/zh-TW/reference/audio/acphal/structs/acp_command_update_contexts) 結構。

## 需求

**標頭：** acphal.h

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

## 另請參閱

[SubmitCommand](/zh-TW/reference/audio/acphal/interfaces/IAcpHal/methods/iacphal_submitcommand)\
[AcpHal](/zh-TW/reference/audio/acphal/acphal_members)


## Related topics

- [ACP_COMMAND_UPDATE_CONTEXTS](/zh-TW/reference/audio/acphal/structs/acp_command_update_contexts.md)
- [ACP_COMMAND_UPDATE_DMA_READ_CONTEXT_ENTRY](/zh-TW/reference/audio/acphal/structs/acp_command_update_dma_read_context_entry.md)
- [ACP_COMMAND_UPDATE_DMA_WRITE_CONTEXT_ENTRY](/zh-TW/reference/audio/acphal/structs/acp_command_update_dma_write_context_entry.md)
- [ACP_COMMAND_UPDATE_PCM_CONTEXT_ENTRY](/zh-TW/reference/audio/acphal/structs/acp_command_update_pcm_context_entry.md)
- [ACP_COMMAND_UPDATE_XMA_CONTEXT_ENTRY](/zh-TW/reference/audio/acphal/structs/acp_command_update_xma_context_entry.md)