structure WDF_DRIVER_CONFIG (wdfdriver.h)

[S’applique à KMDF et à UMDF]

La structure WDF_DRIVER_CONFIG est un paramètre d’entrée pour WdfDriverCreate.

Syntaxe

typedef struct _WDF_DRIVER_CONFIG {
  ULONG                     Size;
  PFN_WDF_DRIVER_DEVICE_ADD EvtDriverDeviceAdd;
  PFN_WDF_DRIVER_UNLOAD     EvtDriverUnload;
  ULONG                     DriverInitFlags;
  ULONG                     DriverPoolTag;
} WDF_DRIVER_CONFIG, *PWDF_DRIVER_CONFIG;

Membres

Size

Taille, en octets, de cette structure.

EvtDriverDeviceAdd

Pointeur vers la fonction de rappel EvtDriverDeviceAdd d’un pilote.

EvtDriverUnload

Pointeur vers la fonction de rappel EvtDriverUnload d’un pilote.

DriverInitFlags

Or au niveau du bit d’une ou plusieurs valeurs typées WDF_DRIVER_INIT_FLAGS qui identifient les indicateurs d’initialisation de pilote.

DriverPoolTag

(KMDF versions 1.5 et ultérieures.) Balise de pool définie par le pilote que l’infrastructure affectera à toutes les allocations de pool du pilote. Les débogueurs affichent cette balise. Pour plus d’informations sur la spécification d’une balise de pool, consultez la section Remarques suivante.

Remarques

Votre pilote peut éventuellement spécifier une balise de pool que l’infrastructure affectera à toutes les allocations de pool du pilote. Les pilotes spécifient généralement une chaîne de caractères allant jusqu’à quatre caractères, délimitées par des guillemets simples, dans l’ordre inverse (par exemple, « dcba »). La valeur ASCII de chaque caractère de la balise doit être comprise entre 0 et 127.

Si DriverPoolTag est égal à zéro, l’infrastructure crée une balise de pool par défaut à l’aide des quatre premiers caractères du nom du service en mode noyau de votre pilote. Si le nom du service commence par « WDF » (le nom n’est pas sensible à la casse et n’inclut pas les guillemets), les quatre caractères suivants sont utilisés. Si moins de quatre caractères sont disponibles, « FxDr » est utilisé.

Pour initialiser une structure WDF_DRIVER_CONFIG, les pilotes doivent appeler WDF_DRIVER_CONFIG_INIT.

Configuration requise

   
Version KMDF minimale 1.0
Version UMDF minimale 2,0
En-tête wdfdriver.h (inclure Wdf.h)

Voir aussi

EvtDriverDeviceAdd

EvtDriverUnload

WDF_DRIVER_CONFIG_INIT

WDF_DRIVER_INIT_FLAGS

WdfDriverCreate