PEP_REGISTER_DEVICE_V2構造体 (pepfx.h)
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 コールバックから戻るまで有効なままです。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows 10 以降でサポートされています。 |
Header | pepfx.h (Pep_x.h を含む) |