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

# SetShapeEqCompCommand

> SetShapeEqCompCommand

# SetShapeEqCompCommand

初始化 SHAPE EQ/Comp 命令。

## 語法

```cpp theme={null}
HRESULT SetShapeEqCompCommand(  
         SHAPE_FLOWGRAPH_COMMAND* command,  
         UINT32 contextId,  
         UINT32 inputMixBuffer,  
         UINT32 sidechainMixBuffer,  
         UINT32 outputMixBuffer  
)  
```

### 參數

*command*   \_Inout\_\
類型：SHAPE\_FLOWGRAPH\_COMMAND\*

要初始化的 [SHAPE\_FLOWGRAPH\_COMMAND](/zh-TW/reference/audio/shapeflowgraph/structs/shape_flowgraph_command) 命令。

*contextId*   \
類型：UINT32

此命令將參考的 EQ/Comp 內容識別碼 (索引)。

*inputMixBuffer*   \
類型：UINT32

輸入混音緩衝區識別碼。

*sidechainMixBuffer*   \
類型：UINT32

旁鏈混音緩衝區。此參數僅用於外部旁鏈，對於一般旁鏈和內部旁鏈則會予以忽略。如需詳細資訊，請參閱 [SHAPE\_EQCOMP\_SIDECHAIN\_MODE](/zh-TW/reference/audio/shapeeqcompcontext/enums/shape_eqcomp_sidechain_mode)。

*outputMixBuffer*   \
類型：UINT32

輸出混音緩衝區識別碼。

### 傳回值

類型：HRESULT

如果函式成功，會傳回 `S_OK`。如果一或多個引數無效，函式會傳回 `E_INVALIDARG`。

## 備註

壓縮器的用途是限制訊號中的動態範圍量。其做法是監視輸入的音量並建立動態增益值。接著，此增益值會作為訊號的乘數，並根據輸入訊號的目前音量適當地縮放訊號。換句話說，它是一種自動音量控制，會持續監視輸入訊號並持續自我調整。

壓縮器只會作用於高於特定臨界值的訊號。如果訊號低於臨界值，訊號會在不變更的情況下通過。臨界值由應用程式設定，作為 EQComp 內容資料的一部分。內容中有可程式化的控制項，可執行壓縮或擴展。

壓縮器會根據比率參數來改變聲音資料。此參數指定當傳入訊號超過臨界值時，應對其進行多少衰減。比率正如其名，是傳入音量與傳出音量的比率。在 2:1 的比率下，超過臨界值的每 2 dB 音量，會使壓縮器輸出超過臨界值 1 dB。在 1:1 的比率下，壓縮器基本上是關閉的。比率由應用程式設定，作為內容資料的一部分。

## 需求

**標頭：** shapeflowgraph.h

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

## 另請參閱

[ACP 概觀](/zh-TW/build/console-features/audio/overviews/acp-overview)

[SHAPE 概觀](/zh-TW/build/console-features/audio/overviews/shape-overview)

[shapeflowgraph](/zh-TW/reference/audio/shapeflowgraph/shapeflowgraph_members)


## Related topics

- [SetShapeEqCompCommand](/ko/reference/audio/shapeflowgraph/functions/setshapeeqcompcommand.md)
- [ShapeFlowGraph](/reference/audio/shapeflowgraph/shapeflowgraph_members.md)