PEP_REGISTER_DEVICE_V2 Struktur (pep_x.h)

Die PEP_REGISTER_DEVICE_V2-Struktur beschreibt ein Gerät, dessen Treiberstapel gerade im 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;

Angehörige

[in] DeviceId

Eine Zeichenfolge, die das Gerät eindeutig identifiziert. Dieses Element ist ein Zeiger auf eine UNICODE_STRING Struktur, die eine Geräteidentifikationszeichenfolgeenthält.

[in] KernelHandle

Ein POHANDLE-Wert, der die Registrierung des Geräts mit PoFx darstellt. Das Plattformerweiterungs-Plug-In (PEP) erhielt dieses Handle zuvor von PoFx während der PEP_DPM_REGISTER_DEVICE Benachrichtigung, dass der PEP informierte, 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 des Geräts beschreibt. Weitere Informationen finden Sie in den Hinweisen.

[out] DeviceHandle

Ein PEPHANDLE-Wert, den der PEP erstellt, um dieses Gerät zu identifizieren. PoFx wird dieses Handle verwenden, um das Gerät in Zukunft 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 angibt, ist für die Behandlung von DPM-Benachrichtigungen für das Gerät verantwortlich.

Bemerkungen

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 Member 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 den PEP gesendet wird. Der Inhalt dieses Puffers bleibt nur gültig, bis der PEP die Behandlung der Benachrichtigung beendet und von der AcceptDeviceNotification Rückruf zurückgibt.

Anforderungen

Siehe auch

AcceptDeviceNotification

PEP_DEVICE_ACCEPTANCE_TYPE

PEP_DEVICE_REGISTER_V2

PEP_DPM_REGISTER_DEVICE

UNICODE_STRING