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

更新所有可伸缩硬件音频处理引擎(Scalable Hardware Audio Processing Engine,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

采样率转换器(Sample Rate Convertor,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](/reference/audio/acphal/structs/acp_command_update_contexts) 结构体。

## 要求

**头文件:** acphal.h

**支持的平台:** XBOX One 系列主机和 XBOX Series 主机

## 另请参阅

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


## Related topics

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