Partager via


IDriverEntry ::OnInitialize, méthode (wudfddi.h)

[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 OnInitialize effectue toutes les opérations nécessaires pour initialiser un pilote.

Syntaxe

HRESULT OnInitialize(
  [in] IWDFDriver *pWdfDriver
);

Paramètres

[in] pWdfDriver

Pointeur vers l’interface IWDFDriver pour l’objet pilote d’infrastructure qui représente le pilote chargé dans le processus hôte.

Valeur retournée

OnInitialize retourne S_OK si le pilote a terminé son initialisation globale. Sinon, cette méthode retourne l’un des codes d’erreur définis dans Winerror.h. Si le pilote retourne un code d’erreur, l’infrastructure ne charge pas le pilote.

Remarques

L’infrastructure crée un objet pilote pour chaque pilote chargé dans le processus hôte du pilote. Lorsqu’un pilote entre dans le système, l’infrastructure appelle OnInitialize pour avertir le pilote et passe l’interface IWDFDriver dans l’appel.

Configuration requise

Condition requise Valeur
Plateforme cible Windows
En-tête wudfddi.h (inclure Wudfddi.h)

Voir aussi

IDriverEntry

IWDFDriver