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 ミニドライバーの初期化フィルター中心の処理に関するページも参照してください。

要件

要件
サポートされている最小のクライアント Microsoft Windows XP 以降のオペレーティング システムと DirectX 8.0 以降の DirectX バージョンで使用できます。
対象プラットフォーム ユニバーサル
Header ks.h (Ks.h を含む)
Library Ks.lib
IRQL PASSIVE_LEVEL

こちらもご覧ください

KsPinRegisterPowerCallbacks