共用方式為


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

    目前音訊篩選圖表會停止數據傳輸。

對於大部分的迷你埠,KSSTATE_ACQUIRE和KSSTATE_PAUSE都無法區分。

轉換一律會在下列兩個序列的其中一個中發生:

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

規格需求

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

另請參閱

IMiniportWavePci::NewStream

IMiniportWavePciStream

KSPROPERTY_CONNECTION_STATE

KSSTATE