EVT_WDFDEVICE_WDM_POST_PO_FX_REGISTER_DEVICE funzione di callback (wdfdevice.h)
[Si applica solo a KMDF]
La funzione di callback EvtDeviceWdmPostPoFxRegisterDevice esegue operazioni specifiche del dispositivo dopo che il framework è stato registrato con il framework di alimentazione.
Sintassi
EVT_WDFDEVICE_WDM_POST_PO_FX_REGISTER_DEVICE EvtWdfdeviceWdmPostPoFxRegisterDevice;
NTSTATUS EvtWdfdeviceWdmPostPoFxRegisterDevice(
[in] WDFDEVICE Device,
[in] POHANDLE PoHandle
)
{...}
Parametri
[in] Device
Handle per un oggetto dispositivo framework.
[in] PoHandle
Handle che rappresenta la registrazione del dispositivo con il framework di alimentazione.
Valore restituito
Valore NTSTATUS che indica l'esito positivo o negativo delle operazioni eseguite in questo callback. Se viene restituito un errore, il framework a sua volta avrà esito negativo IRP_MN_START_DEVICE.
Commenti
Se si scrive un driver KMDF per un dispositivo a singolo componente che definisce più stati di alimentazione funzionale, è possibile registrare una funzione di callback EvtDeviceWdmPostPoFxRegisterDevice per ricevere notifiche dopo la registrazione del framework con il framework di risparmio energia (PoFx).
Per registrare EvtDeviceWdmPostPoFxRegisterDevice, un driver deve chiamare WdfDeviceWdmAssignPowerFrameworkSettings.
Il POHANDLE ricevuto in EvtDeviceWdmPostPoFxRegisterDevice rimane valido fino a quando il driver non torna da EvtDeviceWdmPrePoFxUnregisterDevice.
Il driver può usare POHANDLE per chiamare PoFxSetComponentLatency, PoFxSetComponentResidency e PoFxSetComponentWake per specificare hint di latenza, residenza e riattivazione per il framework di alimentazione.
Il driver può anche usare POHANDLE per chiamare PoFxPowerControl per inviare una richiesta di controllo alimentazione a PoFx.
Un driver KMDF per un dispositivo a più componenti non fornisce EvtDeviceWdmPostPoFxRegisterDevice. Al contrario, un driver di questo tipo riceve il POHANDLE quando chiama PoFxRegisterDevice. Per altre informazioni, vedere Supporto di più stati di alimentazione funzionale per i dispositivi Multiple-Component.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Universale |
| Versione KMDF minima | 1.11 |
| Intestazione | wdfdevice.h (include Wdf.h) |
| IRQL | PASSIVE_LEVEL |