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

# SHARED_SHAPE_CONTEXTS

> SHARED_SHAPE_CONTEXTS

# SHARED\_SHAPE\_CONTEXTS

在与 `XAudio2` 实例共享可伸缩硬件音频处理引擎(Scalable Hardware Audio Processing Engine,SHAPE)和 XBOX Media Audio(XMA)资源时使用此结构体。

## 语法

```cpp theme={null}
typedef struct SHARED_SHAPE_CONTEXTS {  
    SHAPE_CONTEXTS* shapeContexts;  
    UINT32 sharedSrcContextIndex;  
    UINT32 sharedEqCompContextIndex;  
    UINT32 sharedFiltVolContextIndex;  
    UINT32 sharedDmaContextIndex;  
    UINT32 sharedXmaContextIndex;  
    UINT32 sharedPcmContextIndex;  
    UINT32 numSharedSrcContexts;  
    UINT32 numSharedEqCompContexts;  
    UINT32 numSharedFiltVolContexts;  
    UINT32 numSharedDmaContexts;  
    UINT32 numSharedXmaContexts;  
    UINT32 numSharedPcmContexts;  
} SHARED_SHAPE_CONTEXTS  
```

### 成员

*shapeContexts*\
类型:[SHAPE\_CONTEXTS\*](/reference/audio/acphal/structs/shape_contexts)

指向 [SHAPE\_CONTEXTS](/reference/audio/acphal/structs/shape_contexts) 结构体的指针。

*sharedSrcContextIndex*\
类型:UINT32

要共享的第一个采样率转换器(Sample Rate Convertor,SRC)上下文的索引。

*sharedEqCompContextIndex*\
类型:UINT32

要共享的第一个 EQ/Comp 上下文的索引。

*sharedFiltVolContextIndex*\
类型:UINT32

要共享的第一个 Filter/Volume 上下文的索引。

*sharedDmaContextIndex*\
类型:UINT32

要共享的第一个直接内存访问(Direct Memory Access,DMA)上下文的索引。

*sharedXmaContextIndex*\
类型:UINT32

要共享的第一个 XMA 上下文的索引。

*sharedPcmContextIndex*\
类型:UINT32

要共享的第一个脉冲编码调制(PCM)上下文的索引。

*numSharedSrcContexts*\
类型:UINT32

从 *sharedSrcContextIndex* 开始要共享的 SRC 上下文数量。

*numSharedEqCompContexts*\
类型:UINT32

从 *sharedEqCompContextIndex* 开始要共享的 EQ/Comp 上下文数量。

*numSharedFiltVolContexts*\
类型:UINT32

从 *sharedFiltVolContextIndex* 开始要共享的 Filter/Volume 上下文数量。

*numSharedDmaContexts*\
类型:UINT32

从 *sharedDmaContextIndex* 开始要共享的 DMA 上下文数量。

*numSharedXmaContexts*\
类型:UINT32

从 *sharedXmaContextIndex* 开始要共享的 XMA 上下文数量。

*numSharedPcmContexts*\
类型:UINT32

从 *sharedPcmContextIndex* 开始要共享的 PCM 上下文数量。

## 备注

此结构体由 [XAudio2CreateWithSharedContexts](/reference/audio/xaudio2xbox/functions/xaudio2createwithsharedcontexts) 函数使用。该函数的工作方式与 `XAudio2Create` 相同,但会将 `SHARED_SHAPE_CONTEXTS` 作为附加参数。您可以跨多个 `IXAudio2` 实例共享 SHAPE 的状态。

## 要求

**头文件:** acphal.h

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

## 另请参阅

[XAudio2CreateWithSharedContexts](/reference/audio/xaudio2xbox/functions/xaudio2createwithsharedcontexts)\
[XAudio2Create](https://learn.microsoft.com/windows/desktop/api/xaudio2/nf-xaudio2-xaudio2create)\
[AcpHal](/reference/audio/acphal/acphal_members)


## Related topics

- [XAudio2CreateWithSharedContexts](/zh-CN/reference/audio/xaudio2xbox/functions/xaudio2createwithsharedcontexts.md)
- [AcpHal](/zh-CN/reference/audio/acphal/acphal_members.md)
- [SHAPE_CONTEXTS](/zh-CN/reference/audio/acphal/structs/shape_contexts.md)
- [ShapeContexts](/zh-CN/reference/audio/shapecontexts/shapecontexts_members.md)
- [SHAPE_SRC_CONTEXT](/zh-CN/reference/audio/shapesrccontext/structs/shape_src_context.md)