IPnpCallback ::OnD0Entry, méthode (wudfddi.h)
[Avertissement : UMDF 2 est la dernière version de UMDF et remplace UMDF 1. Tous les nouveaux pilotes UMDF doivent être écrits à l’aide de UMDF 2. Aucune nouvelle fonctionnalité n’est ajoutée à UMDF 1 et il existe une prise en charge limitée de UMDF 1 sur les versions plus récentes de Windows 10. Les pilotes Windows universels doivent utiliser UMDF 2. Pour plus d’informations, consultez Bien démarrer avec UMDF.]
La méthode OnD0Entry avertit un pilote lorsqu’un appareil entre dans l’état d’alimentation D0 afin que le pilote puisse effectuer les opérations nécessaires, telles que l’activation de l’appareil.
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 entre dans l’état d’alimentation D0.
[in] previousState
Valeur WDF_POWER_DEVICE_STATE-typée qui identifie l’état d’alimentation de l’appareil avant d’entrer dans l’état d’alimentation D0.
Valeur de retour
Si le rappel OnD0Entry ne rencontre aucune erreur, il doit retourner S_OK ou un autre code d’état pour lequel SUCCEEDED(status) est égal TRUE.
Si elle retourne un code d’état pour lequel SUCCEEDED(status) est égal à FALSE, l’infrastructure supprime l’appareil. Si les pilotes de l’appareil ne prennent pas en charge d’autres appareils sur le système, le gestionnaire d’E/S décharge les pilotes. L’infrastructure informe le gestionnaire PnP, qui tente ensuite de redémarrer l’appareil en demandant au pilote de bus de réumer ses appareils. Si votre pilote a été déchargé, il sera rechargé. Dans ce cas, l’infrastructure n’appelle pas la fonction de rappel iPnpCallback ::OnD0Exit fonction de rappel du pilote.
Les codes d’erreur HRESULT sont définis dans Winerror.h.
Remarques
Un pilote inscrit l’interface IPnpCallback lorsqu’il appelle la méthode IWDFDriver ::CreateDevice pour créer un objet d’appareil.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Windows |
| d’en-tête | wudfddi.h (include Wudfddi.h) |