PEP_REGISTER_DEVICE_V2-Struktur (pepfx.h)

Artikel
02/29/2024

Die PEP_REGISTER_DEVICE_V2-Struktur beschreibt ein Gerät, dessen Treiberstapel gerade beim Windows Power Management Framework (PoFx) registriert wurde.

Syntax

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;

Member

[in] DeviceId

Eine Zeichenfolge, die das Gerät eindeutig identifiziert. Dieser Member ist ein Zeiger auf eine UNICODE_STRING-Struktur , die eine Geräteidentifikationszeichenfolge enthält.

[in] KernelHandle

Ein POHANDLE-Wert, der die Registrierung des Geräts bei PoFx darstellt. Das Plattformerweiterungs-Plug-In (PEP) hat dieses Handle zuvor von PoFx während der PEP_DPM_REGISTER_DEVICE Benachrichtigung erhalten, in der pep darüber informiert wurde, dass der Treiberstapel des Geräts das Gerät bei PoFx registriert hat.

[in] Register

Ein Zeiger auf eine PEP_DEVICE_REGISTER_V2 Struktur, die die Energieverwaltungsattribute aller Komponenten im Gerät beschreibt. Weitere Informationen finden Sie in den Hinweisen.

[out] DeviceHandle

Ein PEPHANDLE-Wert, den pep erstellt, um dieses Gerät zu identifizieren. PoFx verwendet dieses Handle, um das Gerät in zukünftigen DPM-Benachrichtigungen (Device Power Management) zu identifizieren.

[out] DeviceAccepted

Ein PEP_DEVICE_ACCEPTANCE_TYPE Enumerationswert, der angibt, ob der PEP den Besitz des Geräts angibt. Der PEP, der den Besitz beansprucht, ist für die Verarbeitung von DPM-Benachrichtigungen für das Gerät verantwortlich.

Hinweise

Diese Struktur wird von der PEP_DPM_REGISTER_DEVICE Benachrichtigung verwendet. Die ersten drei Member dieser Struktur enthalten eingabewerte, die von PoFx bereitgestellt werden. Die letzten beiden Member enthalten Ausgabewerte, die pep als Reaktion auf diese Benachrichtigung in die Struktur schreibt.

Das Register-Element enthält einen Zeiger auf einen von PoFx zugeordneten Eingabepuffer. PoFx schreibt die PEP_DEVICE_REGISTER_V2-Struktur und die zugehörigen Daten in diese Struktur, bevor die PEP_DPM_REGISTER_DEVICE-Benachrichtigung an pep gesendet wird. Der Inhalt dieses Puffers bleibt nur gültig, bis pep die Verarbeitung der Benachrichtigung beendet und vom AcceptDeviceNotification-Rückruf zurückgibt.