PEP_REGISTER_DEVICE_V2 結構 (pep_x.h)

發行項
02/29/2024

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

POHANDLE 值，表示使用 PoFx 註冊裝置。平臺擴充功能外掛程式 (PEP) 先前在 PEP_DPM_REGISTER_DEVICE通知期間從 PoFx 收到此句柄，告知 PEP 裝置的驅動程式堆疊已向 PoFx 註冊裝置。

[in] Register

PEP_DEVICE_REGISTER_V2 結構的指標，描述裝置中所有元件的電源管理屬性。如需詳細資訊，請參閱＜備註＞。

[out] DeviceHandle

PEP 建立以識別此裝置的 PEPHANDLE 值。 PoFx 會使用此句柄來識別未來裝置電源管理 (DPM) 通知。

[out] DeviceAccepted

PEP_DEVICE_ACCEPTANCE_TYPE列舉值，指出 PEP 是否宣告裝置的擁有權。宣告擁有權的 PEP 負責處理裝置的 DPM 通知。

備註

PEP_DPM_REGISTER_DEVICE 通知會使用此結構。這個結構的前三個成員包含PoFx所提供的輸入值。最後兩個成員包含 PEP 寫入結構的輸出值，以回應此通知。

Register 成員包含 PoFx 所配置之輸入緩衝區的指標。 PoFx 會將 PEP_DEVICE_REGISTER_V2 結構和相關聯的數據寫入此結構，再將 PEP_DPM_REGISTER_DEVICE 通知傳送至 PEP。只有在 PEP 完成處理通知並從 AcceptDeviceNotification 回呼傳回之前，此緩衝區的內容才會保持有效。