PEPCALLBACKNOTIFYDPM コールバック関数 (pepfx.h)

  • [アーティクル]

AcceptDeviceNotification イベント コールバック ルーチンは、Windows 電源管理フレームワーク (PoFx) からのデバイス電源管理 (DPM) 通知を処理します。

構文

PEPCALLBACKNOTIFYDPM Pepcallbacknotifydpm;

BOOLEAN Pepcallbacknotifydpm(
  [in]                ULONG Notification,
  [in, out, optional] PVOID Data
)
{...}

パラメーター

[in] Notification

DPM 通知 ID。 このパラメーターは、PoFx が送信する DPM 通知の種類を指定します。 DPM 通知 ID の一覧については、「 デバイス電源管理 (DPM) 通知」を参照してください。

[in, out, optional] Data

この通知の入力データまたは出力データを含む PoFx によって割り当てられた構造体へのポインター。 この構造体の種類は、 Notification で指定された通知 ID によって異なります。 さまざまな DPM 通知 ID に対して定義されている構造の種類の一覧については、「 デバイス電源管理 (DPM) 通知」を参照してください。

戻り値

AcceptDeviceNotification ルーチンは、通知を処理する場合は TRUE を返し、処理しない場合は FALSE を返す必要があります。

注釈

このルーチンは、デバイスのプラットフォーム拡張機能プラグイン (PEP) によって実装されます。 PEP_INFORMATION構造体の AcceptDeviceNotification メンバーは、AcceptDeviceNotification ルーチンへのポインターです。 PEP は PoFxRegisterPlugin または PoFxRegisterPluginEx ルーチンを呼び出して、PEP の AcceptDeviceNotification ルーチンを PoFx に登録します。

PoFx は、このルーチンを呼び出して、DPM 通知を PEP に送信します。 この呼び出しでは、 Notification パラメーターは通知の種類を指定し、 Data パラメーターは、この通知に関連付けられている型のデータ構造を指します。 DPM 通知 ID とそれに関連付けられている構造の種類の一覧については、「 デバイス電源管理 (DPM) 通知」を参照してください。

DPM 通知は、さまざまなシステム、デバイス、またはコンポーネントのイベントに関する PEP に通知するか、デバイス ドライバーから PEP に要求を渡します。

AcceptDeviceNotification ルーチンは、デバイス ドライバーからのすべての要求を受け入れる必要はありません。たとえば、アイドル状態の常駐ヒントを無視できます。 ただし、PEP は、PEP がデバイスの電源管理通知に対して対処しないことを選択した場合でも、ほとんどのデバイス電源管理通知を理解して受け入れる必要があります。 PEP は、認識されないすべての通知を (FALSE を返すことによって) 処理を拒否する必要があります。

AcceptDeviceNotification ルーチンは、IRQL <= DISPATCH_LEVELで呼び出すことができます。 PEP の AcceptAcpiNotification ルーチンが呼び出される IRQL は、送信される通知の種類によって異なります。 通知の種類は、 Notification パラメーターで指定します。 詳細については、「 デバイス電源管理 (DPM) 通知」の下の個々の参照ページを参照してください。

要件

要件 値
サポートされている最小のクライアント Windows 10 以降でサポートされています。
対象プラットフォーム Windows
ヘッダー pepfx.h (Pep_x.h を含む)
IRQL <= DISPATCH_LEVEL

こちらもご覧ください

PEP_INFORMATION

PoFxRegisterPlugin

PoFxRegisterPluginEx