structure de WDFDEVICE_INIT

[S’applique à KMDF et UMDF]

La structure WDFDEVICE_INIT est une structure opaque définie et allouée par l’infrastructure.

Syntaxe

struct WDFDEVICE_INIT {
  ;      // Reserved.
};

Membres

Les pilotes de fonction et de filtre reçoivent un pointeur vers cette structure comme entrée vers une fonction de rappel EvtDriverDeviceAdd ou comme valeur de retour de WdfControlDeviceInitAllocate.

Les pilotes bus reçoivent un pointeur de structure comme entrée vers une fonction de rappel EvtChildListCreateDevice ou comme valeur de retour de WdfPdoInitAllocate.

Une fois qu’un pilote reçoit une structure WDFDEVICE_INIT , il transmet le pointeur de structure aux fonctions d’initialisation. Ces fonctions utilisent la structure WDFDEVICE_INIT pour stocker les informations utilisées par l’infrastructure pour créer un objet d’appareil framework.

Pour trouver la documentation relative aux méthodes d’initialisation d’appareil, consultez l’en-tête wdfdevice.h.

Après avoir appelé des fonctions d’initialisation, le pilote doit appeler WdfDeviceCreate pour créer l’objet d’appareil framework.

Si votre pilote a reçu la structure WDFDEVICE_INIT d’un appel à WdfPdoInitAllocate ou WdfControlDeviceInitAllocate et si le pilote reçoit une erreur lors de l’appel d’une fonction d’initialisation, le pilote doit appeler WdfDeviceInitFree au lieu de WdfDeviceCreate.

Votre pilote ne doit pas appeler WdfDeviceInitFree après un appel réussi à WdfDeviceCreate.

La structure WDFDEVICE_INIT est disponible dans la version 1.0 et les versions ultérieures de KMDF.

Spécifications

En-tête

Wdftypes.h (include Wdftypes.h)