structure POOL_CREATE_EXTENDED_PARAMS (wdm.h)

Définit la structure POOL_CREATE_EXTENDED_PARAMS.

Syntaxe

typedef struct _POOL_CREATE_EXTENDED_PARAMS {
  ULONG                           Version;
  ULONG                           ParameterCount;
  PPOOL_CREATE_EXTENDED_PARAMETER Parameters;
} POOL_CREATE_EXTENDED_PARAMS, *PPOOL_CREATE_EXTENDED_PARAMS;

Membres

Version

ULONG qui spécifie la version de cette structure. Défini sur POOL_CREATE_PARAMS_VERSION (actuellement 1). Toute autre valeur entraîne l’échec d’ExCreatePool avec STATUS_INVALID_PARAMETER. Les versions futures peuvent étendre cette structure ; les pilotes doivent toujours initialiser ce champ explicitement.

ParameterCount

Nombre d’éléments dans le tableau pointés par Parameters. Doit être 0 si aucun paramètre étendu n’est fourni.

Parameters

Pointeur vers un tableau d’entrées POOL_CREATE_EXTENDED_PARAMETER qui fournissent des paramètres de création supplémentaires. Doit être NULL lorsque ParameterCount est 0. Le champ Type de chaque entrée identifie le type de paramètre. Actuellement, le seul type valide est PoolCreateExtendedParameterName, qui fournit le nom Unicode du pool dans le membre PoolName . Le nom doit être unique dans le contexte du pilote de création et suivre les contraintes d’affectation de noms internes. Les types de paramètres non pris en charge ou en double sont rejetés.

Remarques

Utilisez cette structure pour transmettre des données de création étendue facultatives (ou requises) à ExCreatePool via son argument Params .

Les pools privés paginés et non paginés doivent spécifier exactement un paramètre de nom. Les pools sécurisés ne doivent pas spécifier de paramètre de nom.

Si ParameterCount n’est pas zéro, les paramètres doivent pointer vers un tableau valide et lisible de ces nombreuses entrées.

Les types de paramètres non reconnus par le noyau ou apparaissant plusieurs fois entraînent le retour d’ExCreatePoolSTATUS_INVALID_PARAMETER_3.

La structure est versionnée pour permettre la compatibilité ascendante ; les pilotes ne doivent pas supposer que les champs supplémentaires restent nuls dans les versions futures. Vérifiez toujours la version avant d’interpréter les extensions non reconnues (si la lecture d’une mémoire tampon provient d’un autre emplacement).

Exigences

Voir aussi

ExCreatePool

ExDestroyPool