共用方式為


IMiniportWaveCyclicStream::SetState 方法 (portcls.h)

方法 SetState 會設定數據流播放或錄製的新狀態。

語法

NTSTATUS SetState(
  [in] KSSTATE State
);

參數

[in] State

指定數據流的新狀態。 此參數是 KSSTATE 列舉值。 如需詳細資訊,請參閱接下來的<備註>一節。

傳回值

SetState 如果呼叫成功,會傳回STATUS_SUCCESS。 否則,方法會傳回適當的錯誤碼。

備註

針對音訊篩選圖形,四個 KSSTATE 列舉值會解譯如下:

  • KSSTATE_RUN

    目前音訊篩選圖形中的數據傳輸正在執行,並正常運作。

  • KSSTATE_ACQUIRE

    這是一種過渡狀態,可協助管理KSSTATE_RUN與KSSTATE_STOP之間的轉換。

  • KSSTATE_PAUSE

    這是一種過渡狀態,可協助管理KSSTATE_RUN與KSSTATE_STOP之間的轉換。

  • KSSTATE_STOP

    目前音訊篩選圖形中的數據傳輸已停止。

對於大部分的迷你埠驅動程式,KSSTATE_ACQUIRE和KSSTATE_PAUSE都是無法區分的。

轉換一律會以下列兩個序列之一發生:

  • STOP -> ACQUIRE -> PAUSE -> RUN
  • 執行 -> PAUSE -> ACQUIRE -> STOP
IMiniportWaveCyclic::NewStream 方法會將數據流的初始狀態設定為 KSSTATE_STOP。

規格需求

需求
目標平台 Universal
標頭 portcls.h (包含 Portcls.h)
IRQL PASSIVE_LEVEL

另請參閱

IMiniportWaveCyclic::NewStream

IMiniportWaveCyclicStream

KSPROPERTY_CONNECTION_STATE

KSSTATE