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
目前音訊篩選圖形中的數據傳輸已停止。
轉換一律會以下列兩個序列之一發生:
- STOP -> ACQUIRE -> PAUSE -> RUN
- 執行 -> PAUSE -> ACQUIRE -> STOP
規格需求
需求 | 值 |
---|---|
目標平台 | Universal |
標頭 | portcls.h (包含 Portcls.h) |
IRQL | PASSIVE_LEVEL |