Skip to main content

SetShapeAllocMixBufferCommand

配置虛擬混音緩衝區。

語法

參數

command   _Inout_
類型:SHAPE_FLOWGRAPH_COMMAND*
要初始化的 SHAPE_FLOWGRAPH_COMMAND 命令。 virtualId   
類型:UINT32
混音緩衝區的虛擬識別碼,範圍為 0 到 8191 (含)。每個已配置的混音緩衝區都必須有唯一的虛擬識別碼。 numIn   
類型:UINT32
混音緩衝區的輸入數目。此值指定將輸出至此混音緩衝區的可調整硬體音訊處理引擎 (SHAPE) 區塊數目。 numOut   
類型:UINT32
混音緩衝區的輸出數目。此值指定將從此混音緩衝區讀取的 SHAPE 區塊數目。 attenuation   
類型:SHAPE_MIXBUFFER_ATTENUATION
SHAPE_MIXBUFFER_ATTENUATION 列舉的其中一個成員。此值指定套用至此混音緩衝區所有輸入的 dB 衰減。

傳回值

類型:HRESULT 如果函式成功,會傳回 S_OK。如果一或多個引數無效,函式會傳回 E_INVALIDARG。

備註

所有混音緩衝區都是單一聲道 (單聲道),且必須在使用前配置。雖然實體混音緩衝區總共有 128 個,但可用的虛擬混音緩衝區有 8192 個。實體混音緩衝區可以重複使用,但虛擬混音緩衝區則不行。 執行清單會使用虛擬識別碼來指派混音緩衝區。只有在執行配置命令時,實體混音緩衝區才會繫結至指定的虛擬識別碼。後續使用該虛擬識別碼的命令會導向至已配置的實體混音緩衝區。配置命令會從 SHAPE 處理器分派至混音緩衝區區塊,由該區塊執行虛擬識別碼與實體混音緩衝區的繫結。 許多遊戲並不會直接實作流程圖。XAudio2 和音訊中介軟體會隱含地實作 SHAPE 元件。不過,建構流程圖能提供最大的彈性,並可存取 XBOX One 主機的音訊加速功能。

需求

標頭: shapeflowgraph.h 支援的平台: XBOX One 系列主機與 XBOX Series 主機

另請參閱

ACP 概觀 SHAPE 概觀 shapeflowgraph
Last modified on October 6, 2026