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

另請參閱

• acxcircuit.h 標頭