次の方法で共有


IMiniportWaveCyclicStream::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は区別できません。

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

  • STOP -> ACQUIRE -> PAUSE -> RUN
  • RUN -> PAUSE -> ACQUIRE -> STOP
IMiniportWaveCyclic::NewStream メソッドは、ストリームの初期状態をKSSTATE_STOPに設定します。

要件

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

こちらもご覧ください

IMiniportWaveCyclic::NewStream

IMiniportWaveCyclicStream

KSPROPERTY_CONNECTION_STATE

KSSTATE