IMiniportWavePciStream::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 |