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 |