EVT_WDFDEVICE_WDM_POST_PO_FX_REGISTER_DEVICE Rückruffunktion (wdfdevice.h)

[Gilt nur für KMDF]

Die Rückruffunktion EvtDeviceWdmPostPoFxRegisterDevice führt gerätespezifische Vorgänge aus, nachdem das Framework beim Power Framework registriert wurde.

Syntax

EVT_WDFDEVICE_WDM_POST_PO_FX_REGISTER_DEVICE EvtWdfdeviceWdmPostPoFxRegisterDevice;

NTSTATUS EvtWdfdeviceWdmPostPoFxRegisterDevice(
  [in] WDFDEVICE Device,
  [in] POHANDLE PoHandle
)
{...}

Parameter

[in] Device

Ein Handle für ein Framework-Geräteobjekt.

[in] PoHandle

Ein Handle, das die Registrierung des Geräts beim Power Framework darstellt.

Rückgabewert

Ein NTSTATUS-Wert, der den Erfolg oder Fehler der in diesem Rückruf ausgeführten Vorgänge angibt. Wenn ein Fehler zurückgegeben wird, schlägt das Framework wiederum IRP_MN_START_DEVICE fehl.

Hinweise

Wenn Sie einen KMDF-Treiber für ein Gerät mit einer einzelnen Komponente schreiben, das mehrere Funktionszustände definiert, können Sie eine EvtDeviceWdmPostPoFxRegisterDevice-Rückruffunktion registrieren, um Benachrichtigungen zu erhalten, nachdem sich das Framework beim Power Management Framework (PoFx) registriert hat.

Um EvtDeviceWdmPostPoFxRegisterDevice zu registrieren, muss ein Treiber WdfDeviceWdmAssignPowerFrameworkSettings aufrufen.

Das POHANDLE, das in EvtDeviceWdmPostPoFxRegisterDevice empfangen wurde, bleibt gültig, bis der Treiber von EvtDeviceWdmPrePoFxUnregisterDevice zurückkehrt.

Ihr Treiber kann poHANDLE verwenden, um PoFxSetComponentLatency, PoFxSetComponentResidency und PoFxSetComponentWake aufzurufen, um Latenz-, Residenz- und Wake-Hinweise für das Power Framework anzugeben.

Ihr Treiber kann auch poHANDLE verwenden, um PoFxPowerControl aufzurufen, um eine Energiesteuerungsanforderung an PoFx zu senden.

Ein KMDF-Treiber für ein Gerät mit mehreren Komponenten stellt EvtDeviceWdmPostPoFxRegisterDevice nicht bereit. Stattdessen empfängt ein solcher Treiber den POHANDLE, wenn er PoFxRegisterDevice aufruft. Weitere Informationen finden Sie unter Unterstützung mehrerer funktionsbezogener Energiezustände für Multiple-Component Geräte.

Anforderungen

Weitere Informationen

EvtDeviceWdmPrePoFxUnregisterDevice

WdfDeviceWdmAssignPowerFrameworkSettings