WdfDeviceInitSetPnpPowerEventCallbacks-Funktion (wdfdevice.h)

Artikel
2025-02-07

[Gilt für KMDF und UMDF]

Die WdfDeviceInitSetPnpPowerEventCallbacks Methode registriert die Ereignisrückruffunktionen plug and Play und Power Management 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

Nichts

Bemerkungen

Wenn Ihr Treiber WdfDeviceInitSetPnpPowerEventCallbacksaufruft, muss er dies tun, bevor er WdfDeviceCreateaufruft.

Weitere Informationen zum Aufrufen WdfDeviceCreatefinden Sie unter Creating a Framework Device Object.

Beispiele

Im folgenden Codebeispiel wird eine WDF_PNPPOWER_EVENT_CALLBACKS Struktur initialisiert und anschließend WdfDeviceInitSetPnpPowerEventCallbacksaufgerufen.

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-	Universal
Minimale KMDF-Version	1.0
Mindest-UMDF-Version	2.0
Header-	wdfdevice.h (einschließen Wdf.h)
Library	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)

Siehe auch

WDF_PNPPOWER_EVENT_CALLBACKS_INIT

WdfDeviceInitSetPowerPolicyEventCallbacks

Freigeben über