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

另請參閱

• acxstreams.h 標頭