次の方法で共有

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

    データ 転送は、現在のオーディオ フィルター グラフで停止されます。

ほとんどのミニポート ドライバーでは、KSSTATE_ACQUIREとKSSTATE_PAUSEは区別できません。 IMiniportMidi::NewStream メソッドは、ストリームの初期状態をKSSTATE_STOPに設定します。

遷移は、常に次の 2 つのシーケンスのいずれかで行われます。

  • STOP -> ACQUIRE -> PAUSE -> RUN
  • RUN -> PAUSE -> ACQUIRE -> STOP

要件

要件 値
対象プラットフォーム ユニバーサル
Header portcls.h (Portcls.h を含む)
IRQL PASSIVE_LEVEL

こちらもご覧ください

IMiniportMidi::NewStream

IMiniportMidiStream

KSPROPERTY_CONNECTION_STATE

KSSTATE