Partager via

EVT_WDFDEVICE_WDM_POST_PO_FX_REGISTER_DEVICE fonction de rappel (wdfdevice.h)

  • Article

[S’applique uniquement à KMDF]

La fonction de rappel EvtDeviceWdmPostPoFxRegisterDevice effectue des opérations spécifiques à l’appareil une fois que l’infrastructure est inscrite auprès de l’infrastructure d’alimentation.

Syntaxe

EVT_WDFDEVICE_WDM_POST_PO_FX_REGISTER_DEVICE EvtWdfdeviceWdmPostPoFxRegisterDevice;

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

Paramètres

[in] Device

Handle d’un objet d’appareil framework.

[in] PoHandle

Handle qui représente l’inscription de l’appareil auprès de l’infrastructure d’alimentation.

Valeur retournée

Valeur NTSTATUS indiquant la réussite ou l’échec des opérations effectuées dans ce rappel. Si l’échec est retourné, l’infrastructure échoue à son tour IRP_MN_START_DEVICE.

Remarques

Si vous écrivez un pilote KMDF pour un appareil à composant unique qui définit plusieurs états d’alimentation fonctionnels, vous pouvez inscrire une fonction de rappel EvtDeviceWdmPostPoFxRegisterDevice pour recevoir une notification après l’inscription de l’infrastructure auprès de l’infrastructure de gestion de l’alimentation (PoFx).

Pour inscrire EvtDeviceWdmPostPoFxRegisterDevice, un pilote doit appeler WdfDeviceWdmAssignPowerFrameworkSettings.

Le POHANDLE reçu dans EvtDeviceWdmPostPoFxRegisterDevice reste valide jusqu’à ce que le pilote retourne à partir d’EvtDeviceWdmPrePoFxUnregisterDevice.

Votre pilote peut utiliser POHANDLE pour appeler PoFxSetComponentLatency, PoFxSetComponentResidency et PoFxSetComponentWake afin de spécifier des indicateurs de latence, de résidence et de veille à l’infrastructure d’alimentation.

Votre pilote peut également utiliser poHANDLE pour appeler PoFxPowerControl afin d’envoyer une demande de contrôle d’alimentation à PoFx.

Un pilote KMDF pour un périphérique à plusieurs composants ne fournit pas EvtDeviceWdmPostPoFxRegisterDevice. Au lieu de cela, un tel pilote reçoit le POHANDLE lorsqu’il appelle PoFxRegisterDevice. Pour plus d’informations, consultez Prise en charge de plusieurs états d’alimentation fonctionnels pour les appareils Multiple-Component.

Configuration requise

Condition requise Valeur
Plateforme cible Universal
Version KMDF minimale 1.11
En-tête wdfdevice.h (include Wdf.h)
IRQL PASSIVE_LEVEL

Voir aussi

EvtDeviceWdmPrePoFxUnregisterDevice

WdfDeviceWdmAssignPowerFrameworkSettings