AcxStreamBridgeAddStream 函式 (acxstreams.h)
AcxStreamBridgeAddStream 函式會將現有的 ACXSTREAM 新增至現有的 ACXSTREAMBRIDGE。 如需 ACX 物件的詳細資訊,請參閱 ACX - ACX 物件的摘要。
語法
NTSTATUS AcxStreamBridgeAddStream(
ACXSTREAMBRIDGE Bridge,
ACXSTREAM Stream
);
參數
Bridge
ACXSTREAMBRIDGE 物件會由線路用來傳播串流建立、數據流的狀態轉換和端點線路串流區段之間的DRM設定。 這個物件只會用於多線路(音訊複合)案例中。
Stream
ACXSTREAM 物件代表線路所建立的音訊數據流。 數據流是由根據父線路元素所建立的專案清單所組成。
傳回值
如果呼叫成功,則傳回 STATUS_SUCCESS
。 否則,它會傳回適當的錯誤碼。 如需詳細資訊,請參閱使用NTSTATUS值 。
言論
驅動程式會在下列案例中呼叫 AcxStreamBridgeAddStream:
(a) 驅動程式想要手動選取 ACXSTREAMBRIDGE 以用於目前的 ACXSTREAM。
(b) 驅動程式(及其硬體需求)需要下層 ACXCIRCUIT,也就是靠近裝置網橋接的電路,在上層 ACXCIRCUIT 採取行動之前採取動作。
(c) 司機需要在下層 ACXCIRCUIT 前後採取行動。
針對 AcxStreamBridgeMux 類型,只會建立一個下層 ACXSTREAM,而與新增至此網橋的輸入 ACXSTREAM 數目無關。 這表示輸出 ACXSTREAM(針對本機線路,數據流是以 ACXTARGETSTREAM 表示),只會針對新增至 ACXSTREAMBRIDGE 的第一個 ACXSTREAM 建立。 任何其他輸入 ACXSTREAMs,只要參考這個現有的 ACXTARGETSTREAM 即可。
對於 AcxSTreamBridgeMux 類型,當使用 AcxStreamBridgeRemoveStream 從 ACXSTREAMBRIDGE 移除最後一個輸入 ACXSTREAM 時,會移除輸出 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 |