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 |