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
- RUN -> PAUSE -> ACQUIRE -> STOP
要求
要求 | 價值 |
---|---|
目標平臺 | 普遍 |
標頭 | portcls.h (包括 Portcls.h) |
IRQL | PASSIVE_LEVEL |