acxStreamBridgeRemoveStream 函式 (acxstreams.h)

  • 發行項

AcxStreamBridgeRemoveStream 函式會從 ACXSTREAMBRIDGE 物件中移除指定的 ACXSTREAM。 如需 ACX 對象的詳細資訊，請參閱 ACX - ACX 物件的摘要。

語法

NTSTATUS AcxStreamBridgeRemoveStream(
  ACXSTREAMBRIDGE Bridge,
  ACXSTREAM       Stream
);

參數

Bridge

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

Stream

要從 ACXSTREAMBRIDGE 移除之 ACXSTREAM 物件的句柄。

傳回值

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

備註

此 DDI 只能從驅動程式的數據流清除處理程式內容呼叫。 呼叫端會叫用這個 DDI，以手動解除輸入 ACXSTREAM 與指定 ACXSTREAMBRIDGE 對象的關聯。

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

() 驅動程式想要手動從 ACXSTREAMBRIDGE 移除 ACXSTREAM。

(b) 驅動程式 (及其 H/w 需求) 上層 ACXSTREAM 的需求，亦即線路會更接近串流網橋接腳，以在下層 ACXSTREAM 之前採取動作。

(c) 驅動程式必須在下層 ACXSTREAM 消失之前和之後採取動作。

針對 AcxStreamBridgeMux 類型，只會建立一個下層 ACXSTREAM，而不受新增至此網橋的輸入 ACXSTREAM 數目所建立。 這表示輸出 ACXSTREAM (，該輸出會針對串流以 ACXTARGETSTREAM) 表示的本機線路，只會針對新增至 ACXSTREAMBRIDGE 的第一個 ACXSTREAM 建立。 任何其他輸入 ACXSTREAM 只會參考這個現有的 ACXTARGETSTREAM。

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

範例

範例使用方式如下所示。

    status = AcxStreamBridgeAddStream(bridge, stream);

    // Get I/O target to send I/O to the target stream.
    targetStream = AcxStreamBridgeGetTargetStream(bridge, stream);
 
    // Target stream is closed if this was last input ACXSTREAM removed.
    status = AcxStreamBridgeRemoveStream(bridge, stream);

ACX 需求

最小 ACX 版本： 1.0

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

規格需求

需求 值
標頭 acxstreams.h
IRQL PASSIVE_LEVEL

另請參閱