IMiniportWavePciStream::SetState メソッド (portcls.h)
メソッドは SetState
、ストリーム トランスポートの状態を変更します。
構文
NTSTATUS SetState(
[in] KSSTATE State
);
パラメーター
[in] State
ストリームの新しい状態を指定します。 このパラメーターは KSSTATE 列挙値です。 詳細については、「解説」を参照してください。
戻り値
SetState
は、呼び出しが成功した場合にSTATUS_SUCCESSを返します。 それ以外の場合、メソッドは適切なエラー コードを返します。
注釈
オーディオ フィルター グラフの場合、4 つの KSSTATE 列挙値は次のように解釈されます。
-
KSSTATE_RUN
現在のオーディオ フィルター グラフ内のデータ トランスポートが実行され、通常どおりに機能しています。
-
KSSTATE_ACQUIRE
これは、KSSTATE_RUNとKSSTATE_STOP間の遷移を管理するのに役立つ遷移状態です。
-
KSSTATE_PAUSE
これは、KSSTATE_RUNとKSSTATE_STOP間の遷移を管理するのに役立つ遷移状態です。
-
KSSTATE_STOP
データ転送は、現在のオーディオ フィルター グラフで停止されます。
遷移は常に、次の 2 つのシーケンスのいずれかで行われます。
- STOP -> ACQUIRE -> PAUSE -> RUN
- RUN -> PAUSE -> ACQUIRE -> STOP
要件
要件 | 値 |
---|---|
対象プラットフォーム | ユニバーサル |
Header | portcls.h (Portcls.h を含む) |
IRQL | PASSIVE_LEVEL |