PEP_REGISTER_DEVICE_V2構造体 (pep_x.h)

[アーティクル]
08/07/2023

PEP_REGISTER_DEVICE_V2構造体は、ドライバースタックが Windows 電源管理フレームワーク (PoFx) に登録したばかりのデバイスを表します。

構文

typedef struct _PEP_REGISTER_DEVICE_V2 {
  [in]  PCUNICODE_STRING           DeviceId;
  [in]  POHANDLE                   KernelHandle;
  [in]  PPEP_DEVICE_REGISTER_V2    Register;
  [out] PEPHANDLE                  DeviceHandle;
  [out] PEP_DEVICE_ACCEPTANCE_TYPE DeviceAccepted;
} PEP_REGISTER_DEVICE_V2, *PPEP_REGISTER_DEVICE_V2;

メンバー

[in] DeviceId

デバイスを一意に識別する文字列。このメンバーは、デバイス識別文字列を含むUNICODE_STRING構造体へのポインターです。

[in] KernelHandle

PoFx を使用したデバイスの登録を表す POHANDLE 値。プラットフォーム拡張機能プラグイン (PEP) は、デバイスのドライバースタックがデバイスを PoFx に登録したことを PEP に通知した PEP_DPM_REGISTER_DEVICE 通知中に、PoFx からこのハンドルを以前に受信しました。

[in] Register

デバイス内のすべてのコンポーネントの電源管理属性を記述する PEP_DEVICE_REGISTER_V2 構造体へのポインター。詳細については、「解説」を参照してください。

[out] DeviceHandle

このデバイスを識別するために PEP によって作成される PEPHANDLE 値。 PoFx では、このハンドルを使用して、将来のデバイス電源管理 (DPM) 通知でデバイスを識別します。

[out] DeviceAccepted

PEP がデバイスの所有権を要求するかどうかを示すPEP_DEVICE_ACCEPTANCE_TYPE列挙値。所有権を要求する PEP は、デバイスの DPM 通知を処理する役割を担います。

注釈

この構造体は、 PEP_DPM_REGISTER_DEVICE 通知によって使用されます。この構造体の最初の 3 つのメンバーには、PoFx によって提供される入力値が含まれています。最後の 2 つのメンバーには、この通知に応答して PEP が構造体に書き込む出力値が含まれています。

Register メンバーには、PoFx によって割り当てられた入力バッファーへのポインターが含まれています。 PoFx は、 PEP_DPM_REGISTER_DEVICE 通知を PEP に送信する前に、 PEP_DEVICE_REGISTER_V2 構造体と関連付けられたデータをこの構造体に書き込みます。このバッファーの内容は、PEP が通知の処理を完了し、 AcceptDeviceNotification コールバックから戻るまで有効なままです。