acxCircuitCreate 函式 (acxcircuit.h)
AcxCircuitCreate 函式是用來建立 ACXCIRCUIT。
語法
NTSTATUS AcxCircuitCreate(
WDFDEVICE Device,
PWDF_OBJECT_ATTRIBUTES Attributes,
PACXCIRCUIT_INIT *Config,
ACXCIRCUIT *Circuit
);
參數
Device
WDFDEVICE 物件 (將與線路相關聯的 Framework 物件 摘要) 中所述。
Attributes
使用用來設定各種物件值 之WDF_OBJECT_ATTRIBUTES 定義的其他屬性：清除和終結回呼、內容類型，以及指定其父 WDF 物件。
Config
定義線路處理站初始化的ACXCIRCUIT_INIT結構。 ACXCIRCUIT_INIT是用於線路處理站初始化的不透明物件。 使用 AcxCircuitInitAllocate 初始化ACXCIRCUIT_INIT結構。
Circuit
接收新 ACXCIRCUIT 物件句柄之位置的指標。 如需詳細資訊，請參閱 ACX 物件的摘要。
傳回值
如果呼叫成功，則傳 STATUS_SUCCESS 回 。 否則，它會傳回適當的錯誤碼。 如需詳細資訊，請參閱 使用NTSTATUS值。
備註
ACXCIRCUIT 代表使用者感知音訊裝置 (喇叭、麥克風等 ) 的完整或部分 (多重線路) 音頻路徑。
ACXCIRCUIT 至少有一個輸入針腳 (ACXPIN) 和一個輸出針腳 (ACXPIN) ，而且可能會匯總一或多個 ACXELEMENTS 物件。 根據預設，ACXELEMENT 會以相同的元件順序「連線」。
範例
範例使用方式如下所示。
status = AcxCircuitInitAssignName(circuitInit, &circuitName);
//
// Add circuit type.
//
AcxCircuitInitSetCircuitType(circuitInit, AcxCircuitTypeRender);
//
// Assign the circuit's pnp-power callbacks.
//
ACX_CIRCUIT_PNPPOWER_CALLBACKS_INIT(&powerCallbacks);
powerCallbacks.EvtAcxCircuitPowerUp = SdcaR_EvtCircuitPowerUp;
powerCallbacks.EvtAcxCircuitPowerDown = SdcaR_EvtCircuitPowerDown;
AcxCircuitInitSetAcxCircuitPnpPowerCallbacks(circuitInit, &powerCallbacks);
//
// Set circuit-callbacks.
//
status = AcxCircuitInitAssignAcxCreateStreamCallback(
circuitInit,
SdcaR_EvtCircuitCreateStream);
//
// Create the circuit.
//
WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE(&attributes, SDCA_RENDER_CIRCUIT_CONTEXT);
status = AcxCircuitCreate(Device, &attributes, &circuitInit, &circuit);
ACX 需求
最小 ACX 版本： 1.0
如需 ACX 版本的詳細資訊，請參閱 ACX 版本概觀。
規格需求
| 需求 | 值 |
|---|---|
| 標頭 | acxcircuit.h |
| IRQL | PASSIVE_LEVEL |