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 を含む)

こちらもご覧ください

AcceptDeviceNotification

PEP_DEVICE_ACCEPTANCE_TYPE

PEP_DEVICE_REGISTER_V2

PEP_DPM_REGISTER_DEVICE

UNICODE_STRING