PEP_REGISTER_DEVICE_V2 Struktur (pep_x.h)

Artikel
08/07/2023

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. Dieses Element 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) erhielt dieses Handle zuvor von PoFx während der PEP_DPM_REGISTER_DEVICE Benachrichtigung, die den PEP darüber informierte, dass der Treiberstapel des Geräts das Gerät mit 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 beansprucht. Das PEP, das 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 Elemente dieser Struktur enthalten Eingabewerte, die von PoFx bereitgestellt werden. Die letzten beiden Member enthalten Ausgabewerte, die der PEP als Reaktion auf diese Benachrichtigung in die Struktur schreibt.

Das Register-Element enthält einen Zeiger auf einen Von PoFx zugewiesenen 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 die PEP gesendet wird. Der Inhalt dieses Puffers bleibt nur gültig, bis pep die Verarbeitung der Benachrichtigung abgeschlossen hat und vom AcceptDeviceNotification-Rückruf zurückgibt.