WDF_DRIVER_CONFIG structure (wdfdriver.h)

Article
02/27/2024

[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 de plusieurs valeurs WDF_DRIVER_INIT_FLAGS typées qui identifient les indicateurs d’initialisation du pilote.

DriverPoolTag

(KMDF versions 1.5 et ultérieures.) Balise de pool définie par le pilote que le framework affectera à toutes les allocations de pool de pilotes. 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 de pilotes. Les pilotes spécifient généralement une chaîne de caractères de quatre caractères maximum, délimitée 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 en utilisant les quatre premiers caractères du nom de service en mode noyau de votre pilote. Si le nom du service commence par « WDF » (le nom ne respecte pas 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.