AcxStreamBridgeAddStream 函式 (acxstreams.h)

  • 發行項

AcxStreamBridgeAddStream 函式會將現有的 ACXSTREAM 新增至現有的 ACXSTREAMBRIDGE。 如需 ACX 對象的詳細資訊，請參閱 ACX 物件摘要。

語法

NTSTATUS AcxStreamBridgeAddStream(
  ACXSTREAMBRIDGE Bridge,
  ACXSTREAM       Stream
);

參數

Bridge

ACXSTREAMBRIDGE 物件是由線路用來傳播串流建立、數據流的狀態轉換和端點線路串流區段之間的DRM設定。 這個物件只適用於多重線路 (音頻複合) 案例。

Stream

ACXSTREAM 物件代表線路所建立的音訊數據流。 數據流是由根據父線路元素所建立的專案清單所組成。

傳回值

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

備註

驅動程序在這些案例中呼叫 AcxStreamBridgeAddStream：

() 驅動程式想要手動選取要用於目前 ACXSTREAM 的 ACXSTREAMBRIDGE。

(b) 驅動程式 (及其硬體需求) 需要下層 ACXCIRCUIT，也就是靠近裝置網橋接腳的線路，在上層 ACXCIRCUIT 採取動作之前採取動作。

(c) 驅動程式必須在下層 ACXCIRCUIT 前後採取動作。

針對 AcxStreamBridgeMux 類型，只會建立一個下層 ACXSTREAM，與新增至此網橋的輸入 ACXSTREAM 數目無關。 這表示輸出 ACXSTREAM (，該輸出 (數據流會以 ACXTARGETSTREAM) 表示，只會針對新增至 ACXSTREAMBRIDGE 的第一個 ACXSTREAM 建立。 任何其他輸入 ACXSTREAM，只要參考這個現有的 ACXTARGETSTREAM 即可。

針對 AcxSTreamBridgeMux 類型，當最後一個輸入 ACXSTREAM 從 ACXSTREAMBRIDGE 移除與 AcxStreamBridgeRemoveStream 時，就會移除輸出 ACXTARGETSTREAM。

範例

範例使用方式如下所示。 未顯示錯誤處理程式碼。

        status = AcxStreamBridgeCreate(Circuit, &attributes, &bridgeCfg, &bridge);

        // Pin ID 1 is the bridge pin in this example.
        bridgePin = AcxCircuitGetPinById(Circuit, 1);
        
        status = AcxPinAddStreamBridges(bridgePin, &bridge, 1);

        status = AcxStreamBridgeAddStream(bridge, stream);

ACX 需求

最低 ACX 版本： 1.0

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

規格需求

需求 值
標頭 acxstreams.h
IRQL PASSIVE_LEVEL

另請參閱