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

믹스 버퍼에서 읽는 Direct Memory Access(DMA) 항목의 개수입니다.

*dmaWriteEntryCount*\
형식: UINT32

믹스 버퍼에 쓰는 DMA 항목의 개수입니다.

*pcmEntryCount*\
형식: UINT32

pulse-code modulation(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](/ko/reference/audio/acphal/structs/acp_command_update_contexts.md)
- [ACP_COMMAND_UPDATE_DMA_READ_CONTEXT_ENTRY](/ko/reference/audio/acphal/structs/acp_command_update_dma_read_context_entry.md)
- [ACP_COMMAND_UPDATE_DMA_WRITE_CONTEXT_ENTRY](/ko/reference/audio/acphal/structs/acp_command_update_dma_write_context_entry.md)
- [ACP_COMMAND_UPDATE_XMA_CONTEXT_ENTRY](/ko/reference/audio/acphal/structs/acp_command_update_xma_context_entry.md)
- [ACP_COMMAND_UPDATE_PCM_CONTEXT_ENTRY](/ko/reference/audio/acphal/structs/acp_command_update_pcm_context_entry.md)