PFNKSPINSETDEVICESTATE コールバック関数 (ks.h)

接続状態プロパティ 'set' IOCTL が到着したために KSPIN 構造体の状態が変更されると、AVStream ミニドライバーの AVStrMiniPinSetDeviceState ルーチンが呼び出されます。 通常、これは、ハードウェアの状態を変更する必要があるミニドライバーによって提供されます。

構文

PFNKSPINSETDEVICESTATE Pfnkspinsetdevicestate;

NTSTATUS Pfnkspinsetdevicestate(
  [in] PKSPIN Pin,
  [in] KSSTATE ToState,
  [in] KSSTATE FromState
)
{...}

パラメーター

[in] Pin

状態が変更されている KSPIN 構造体へのポインター。

[in] ToState

IOCTL を受信した後のターゲット KSSTATE 。

[in] FromState

前の KSSTATE。

戻り値

状態STATUS_SUCCESS設定しようとした場合に返されたエラー コードを返します。 STATUS_PENDINGを返さないでください。 フィルター 制御ミューテックスは、この関数の間に保持されます。 AVStream のフィルター 制御ミューテックスに関するページを参照してください。

注釈

ミニドライバーは、そのKSPIN_DISPATCH構造体の SetDeviceState メンバーで、このルーチンのアドレスを指定します。

ミニドライバーは、ピンの最初の接続時に停止を受け取りません。

標準トランスポート メカニズム (標準インターフェイス/標準メディア、または KSPIN_DESCRIPTOR_EXでのKSPIN_FLAG_USE_STANDARD_TRANSPORTの明示的な使用) を使用するピンは、このルーチンを介して所有パイプを介してフィルター処理された状態の変更を受け取ります。 これは、遷移が 1 つのステップを超えないことを意味します。 つまり、 KSSTATE_STOP はKSSTATE_ACQUIREに遷移 し、KSSTATE_ACQUIRE はKSSTATE_PAUSEに遷移します。 さらに、このルーチンで受け取った状態の変更は、KSPIN 構造体の DeviceState メンバーで報告されたピンの個々の状態ではなく、パイプ全体の状態を表します。

標準トランスポート メカニズム (非標準インターフェイス、非標準メディア、または KSPIN_DESCRIPTOR_EXでのKSPIN_FLAG_DO_NOT_USE_STANDARD_TRANSPORTの明示的な使用) を使用しないピンは、このルーチンを介してフィルター処理されていない状態の変更を受け取ります。 そのため、1 ステップ以上ジャンプする状態の変更に対処するには、標準以外のトランスポート ピンを準備する必要があります。 たとえば、介入KSSTATE_PAUSEなしで 、KSSTATE_RUN から KSSTATE_STOP へのジャンプを考えてみましょう。 さらに、このルーチンに報告される状態は、関連する KSPIN 構造体の DeviceState メンバーで報告された状態と同じになります。

このルーチンは省略可能です。

要件

こちらもご覧ください

KSPIN_DISPATCH