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