Méthode IPnpCallback ::OnD0Entry (wudfddi.h)

Article
02/27/2024

[Avertissement : UMDF 2 est la dernière version d’UMDF et remplace UMDF 1. Tous les nouveaux pilotes UMDF doivent être écrits à l’aide d’UMDF 2. Aucune nouvelle fonctionnalité n’est ajoutée à UMDF 1 et la prise en charge d’UMDF 1 est limitée sur les versions plus récentes de Windows 10. Les pilotes Windows universels doivent utiliser UMDF 2. Pour plus d’informations, consultez Prise en main avec UMDF.]

La méthode OnD0Entry avertit un pilote lorsqu’un appareil passe à l’état d’alimentation D0 afin que le pilote puisse effectuer les opérations nécessaires, telles que l’activation du périphérique.

Syntaxe

HRESULT OnD0Entry(
  [in] IWDFDevice             *pWdfDevice,
  [in] WDF_POWER_DEVICE_STATE previousState
);

Paramètres

[in] pWdfDevice

Pointeur vers l’interface IWDFDevice pour l’objet d’appareil de l’appareil qui passe à l’état d’alimentation D0.

[in] previousState

Valeur WDF_POWER_DEVICE_STATE typée qui identifie l’état d’alimentation de l’appareil avant qu’il ne passe à l’état d’alimentation D0.

Valeur retournée

Si le rappel OnD0Entry ne rencontre aucune erreur, il doit retourner S_OK ou un autre code status pour lequel SUCCEEDED(status) est égal à TRUE.

S’il retourne un code status pour lequel SUCCEEDED(status) est égal à FALSE, l’infrastructure supprime l’appareil. Si les pilotes du périphérique ne prennent pas en charge d’autres périphériques sur le système, le gestionnaire d’E/S décharge les pilotes. L’infrastructure avertit le gestionnaire PnP, qui tente ensuite de redémarrer l’appareil en demandant au pilote de bus de ré-énumérer ses appareils. Si votre pilote a été déchargé, il est rechargé. Dans ce cas, l’infrastructure n’appelle pas la fonction de rappel IPnpCallback ::OnD0Exit du pilote.

Les codes d’erreur HRESULT sont définis dans Winerror.h.