AcxCircuitAddPins 函式 (acxcircuit.h)

AcxCircuitAddPins 函式會將針腳新增至 ACXCIRCUIT。

語法

NTSTATUS AcxCircuitAddPins(
  ACXCIRCUIT Circuit,
  ACXPIN     *Pins,
  ULONG      PinsCount
);

參數

Circuit

現有的 ACXCIRCUIT 物件。 如需 ACX 對象的詳細資訊，請參閱 ACX 物件的摘要。

Pins

將新增至線路的現有 ACXPIN 物件。

PinsCount

將新增至線路的針腳數目。 這是一個以計數為基礎的計數。

傳回值

如果呼叫成功，則傳 STATUS_SUCCESS 回 。 否則，它會傳回適當的錯誤碼。 如需詳細資訊，請參閱 使用NTSTATUS值。

備註

ACXCIRCUIT 至少有輸入針腳 (ACXPIN) 和輸出針腳 (ACXPIN) ，而且可能會匯總一或多個 ACXELEMENT。

每個 ACXCIRCUIT 至少有一個接收針腳和一個來源針腳。 ACX 架構會使用這些針腳來公開線路與音訊堆疊的連線。 針對轉譯線路，來源針腳可用來控制從線路建立的任何數據流 (裝置屬性) 轉譯行為。 針對擷取線路，接收針腳可用來控制從線路建立的任何數據流) (裝置屬性的擷取行為。

ACXPIN 是用來控制音訊路徑中串流的物件。 針對簡單的 ACXCIRCUIT 拓撲，如果只有一個 ACXPIN 存在，ACX 就能夠自動建立另一個 ACXPIN。

範例

範例使用方式如下所示。

    ACXPIN pin;  
 
    WDF_OBJECT_ATTRIBUTES_INIT(&attributes);
    attributes.ParentObject = circuit;

    status = AcxPinCreate(circuit, &attributes, &pinCfg, &(pin[1]));
  
    // Add the supported formats to the Default mode for the circuit
    //
    formatList = AcxPinGetRawDataFormatList(pin[1]);
  
    status = AcxDataFormatListAddDataFormat(formatList, formatPcm16000c1);
  
    //
    // Add the default streaming pin, using default pin id.
    //
    status = AcxCircuitAddPins(circuit, &(pin[1]), 1);

ACX 需求

最小 ACX 版本： 1.0

如需 ACX 版本的詳細資訊，請參閱 ACX 版本概觀。

規格需求

需求	值
標頭	acxcircuit.h
IRQL	PASSIVE_LEVEL

另請參閱

• acxcircuit.h 標頭