WdfDeviceInitSetPnpPowerEventCallbacks-Funktion (wdfdevice.h)

  • Artikel

[Gilt für KMDF und UMDF]

Die WdfDeviceInitSetPnpPowerEventCallbacks-Methode registriert die Plug & Play- und Energieverwaltungsereignisrückruffunktionen eines Treibers.

Syntax

void WdfDeviceInitSetPnpPowerEventCallbacks(
  [in] PWDFDEVICE_INIT               DeviceInit,
  [in] PWDF_PNPPOWER_EVENT_CALLBACKS PnpPowerEventCallbacks
);

Parameter

[in] DeviceInit

Ein vom Aufrufer bereitgestellter Zeiger auf eine WDFDEVICE_INIT-Struktur .

[in] PnpPowerEventCallbacks

Ein Zeiger auf eine aufruferinitialisierte WDF_PNPPOWER_EVENT_CALLBACKS-Struktur .

Rückgabewert

Keine

Bemerkungen

Wenn Ihr Treiber WdfDeviceInitSetPnpPowerEventCallbacks aufruft, muss er dies tun, bevor er WdfDeviceCreate aufruft.

Weitere Informationen zum Aufrufen von WdfDeviceCreate finden Sie unter Erstellen eines Framework-Geräteobjekts.

Beispiele

Im folgenden Codebeispiel wird eine WDF_PNPPOWER_EVENT_CALLBACKS-Struktur initialisiert und anschließend WdfDeviceInitSetPnpPowerEventCallbacks aufgerufen.

WDF_PNPPOWER_EVENT_CALLBACKS  pnpPowerCallbacks;

WDF_PNPPOWER_EVENT_CALLBACKS_INIT(&pnpPowerCallbacks);
pnpPowerCallbacks.EvtDevicePrepareHardware = SerialEvtPrepareHardware;
pnpPowerCallbacks.EvtDeviceReleaseHardware = SerialEvtReleaseHardware;
pnpPowerCallbacks.EvtDeviceD0Entry = SerialEvtDeviceD0Entry;
pnpPowerCallbacks.EvtDeviceD0Exit = SerialEvtDeviceD0Exit;
WdfDeviceInitSetPnpPowerEventCallbacks(
                                       DeviceInit,
                                       &pnpPowerCallbacks
                                       );

Anforderungen

Anforderung Wert
Zielplattform Universell
KMDF-Mindestversion 1.0
UMDF-Mindestversion 2.0
Kopfzeile wdfdevice.h (einschließen von Wdf.h)
Bibliothek Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL <= DISPATCH_LEVEL
DDI-Complianceregeln ChildDeviceInitAPI(kmdf), DeviceInitAPI(kmdf), DriverCreate(kmdf), DrvAckIoStop(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), PdoDeviceInitAPI(kmdf)

Weitere Informationen

WDF_PNPPOWER_EVENT_CALLBACKS_INIT

WdfDeviceInitSetPowerPolicyEventCallbacks