WDFDEVICE_INIT structure

[S’applique à KMDF et UMDF]

La structure WDFDEVICE_INIT est une structure opaque qui est définie et allouée par le framework.

Syntax

struct WDFDEVICE_INIT {
  ;      // Reserved.
};

Membres---

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

Les pilotes de bus reçoivent un pointeur de structure en entrée d’une fonction de rappel EvtChildListCreateDevice ou en tant que 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 que l’infrastructure utilise pour créer un objet d’appareil d’infrastructure.

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

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

Si votre pilote a reçu la structure WDFDEVICE_INIT d’un appel à WdfPdoInitAllocate ou WdfControlDeviceInitAllocate, et si le pilote reçoit une erreur en appelant 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.

Configuration requise

En-tête

Wdftypes.h (inclure Wdftypes.h)