次の方法で共有

KsFilterRegisterPowerCallbacks 関数 (ks.h)

  • [アーティクル]

KsFilterRegisterPowerCallbacks 関数は、Filterの電源管理コールバックを登録します。

構文

void KsFilterRegisterPowerCallbacks(
  [in]           PKSFILTER        Filter,
  [in, optional] PFNKSFILTERPOWER Sleep,
  [in, optional] PFNKSFILTERPOWER Wake
);

パラメーター

[in] Filter

電源コールバックを登録する KSFILTER 構造体へのポインター。 電源通知メッセージを受信するには、フィルター フィルター中心にする必要があります。

[in, optional] Sleep

デバイスのスリープ要求を処理する関数へのポインター。 NULL 場合、スリープ コールバックは登録されません。 詳細については、以下の「解説」セクションを参照してください。

[in, optional] Wake

デバイスのウェイク要求を処理する関数へのポインター。 NULL 場合、ウェイク コールバックは指定されません。 詳細については、以下の「解説」セクションを参照してください。

戻り値

何一つ

備考

警告

Sleep コールバックまたは Wake コールバック内からフィルター 制御ミューテックス* を取得しようとしないでください。または、デッドロックが発生する可能性があります。 ミューテックスの詳細については、AVStream のミューテックスを参照してください。

2 つのコールバックは、次のようにプロトタイプ化する必要があります。

void Sleep/Wake (IN PKSFILTER Filter, IN DEVICE_POWER_STATE State);

Filter がフィルター中心のフィルターであり、デバイスがスリープ状態になる場合、スリープ コールバックが行われます。 Filter がフィルター中心のフィルターであり、デバイスがウェイクしている場合、Wake コールバックが行われます。

デバイスの電源状態の詳細については、「デバイスの電源状態を参照してください。

AVStream ミニドライバー の初期化と Filter-Centric 処理の も参照してください。

必要条件

要件 価値
サポートされる最小クライアント Microsoft Windows XP 以降のオペレーティング システムと DirectX 8.0 以降の DirectX バージョンで使用できます。
ターゲット プラットフォーム の 万国
ヘッダー ks.h (Ks.h を含む)
ライブラリ Ks.lib
IRQL PASSIVE_LEVEL

関連項目

KsPinRegisterPowerCallbacks の