AcxStreamBridgeCreate 函式 (acxstreams.h)
AcxStreamBridgeCreate 函式會使用ACX_STREAM_BRIDGE_CONFIG來建立線路的 StreamBridge。
ACXSTREAMBRIDGE 是由線路用來傳播串流建立、串流狀態轉換和端點線路串流區段之間的DRM設定。 這個物件只會用於多線路 (音頻複合) 案例中。
語法
NTSTATUS AcxStreamBridgeCreate(
ACXCIRCUIT AcxCircuit,
PWDF_OBJECT_ATTRIBUTES Attributes,
PACX_STREAM_BRIDGE_CONFIG Config,
ACXSTREAMBRIDGE *StreamBridge
);
參數
AcxCircuit
接收相關聯 ACXCIRCUIT 物件句柄之位置的指標。 如需 ACX 對象的詳細資訊，請參閱 ACX - ACX 物件的摘要。
Attributes
使用用來設定各種物件值 之WDF_OBJECT_ATTRIBUTES 定義的其他屬性：清除和終結回呼、內容類型，以及指定其父物件。 如需詳細資訊，請參閱 本主題WDF_OBJECT_ATTRIBUTES 結構和備註一節。
Config
定義組態 的ACX_STREAM_BRIDGE_CONFIG 結構。
StreamBridge
接收新 ACXSTREAMBRIDGE 物件句柄之位置的指標。
傳回值
如果呼叫成功，則傳 STATUS_SUCCESS 回 。 否則，它會傳回適當的錯誤碼。 如需詳細資訊，請參閱 使用NTSTATUS值。
備註
音訊端點是一或多個音訊線路的集合， (ACXCIRCUIT 物件) ，這些物件會組合成建立完整的音訊路徑。 ACX 驅動程式通常會為不同的音訊端點建立音訊線路，不過 ACX 不會禁止相同驅動程式建立的線路成為相同音訊端點集合的一部分，只要它們屬於不同的裝置堆疊即可。 音訊端點是由相同或不同的音訊驅動程式所建立的音訊線路集合。
根據預設，新的 ACXSTREAMBRIDGE 物件的父系是指定的 ACXCIRCUIT。 您可以使用 WDF_OBJECT_ATTRIBUTES 結構的 ParentObject 成員，將 ACXCIRCUIT 指定為上階的不同父系。 架構會在刪除父物件時刪除 ACXSTREAMBRIDGE 物件。
您的驅動程式在使用 物件完成時，可以刪除 ACXSTREAMBRIDGE 物件;否則，物件會保留在刪除父系之前，也就是在 ACXCIRCUIT 初始化/建立期間建立它的情況。
針腳可以與零、一或多個 ACXSTREAMBRIDGE 相關聯。 ACX 會搜尋相關聯的 ACXPIN 訊號處理模式清單，以取得串流訊號處理模式比對。 搜尋會在第一個相符專案停止。
如果驅動程式未建立 ACXCIRCUIT，ACXCIRCUIT 會為 ACXCIRCUIT 建立預設 ACXSTREAMBRIDGE，而且驅動程式未停用 AcxCircuitInitDisableDefaultStreamBridgeHandling 函式的預設串流網橋處理。
範例
範例使用方式如下所示。
ACX_STREAM_BRIDGE_CONFIG bridgeCfg;
ACXSTREAMBRIDGE bridge = NULL;
ACX_STREAM_BRIDGE_CONFIG_INIT(&bridgeCfg);
bridgeCfg.InModesCount = 1;
bridgeCfg.InModes = inModes;
bridgeCfg.OutMode = &AUDIO_SIGNALPROCESSINGMODE_DEFAULT;
status = AcxStreamBridgeCreate(circuit, &attributes, &bridgeCfg, &bridge);
ACX 需求
最小 ACX 版本： 1.0
如需 ACX 版本的詳細資訊，請參閱 ACX 版本概觀。
規格需求
| 需求 | 值 |
|---|---|
| 標頭 | acxstreams.h |
| IRQL | PASSIVE_LEVEL |