PEP_REGISTER_DEVICE_V2 Struktur (pep_x.h)
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.
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Wird ab Windows 10 unterstützt. |
Kopfzeile | pep_x.h (einschließlich Pep_x.h) |