structure POOL_EXTENDED_PARAMETER (wdm.h)

Spécifie les informations de paramètre étendues fournies par le pilote lors de l’appel de ExAllocatePool3.

Syntaxe

C++

typedef struct _POOL_EXTENDED_PARAMETER {
  struct {
    ULONG64 Type : POOL_EXTENDED_PARAMETER_TYPE_BITS;
    ULONG64 Optional : POOL_EXTENDED_PARAMETER_REQUIRED_FIELD_BITS;
    ULONG64 Reserved : POOL_EXTENDED_PARAMETER_RESERVED_BITS;
  } DUMMYSTRUCTNAME;
  union {
    ULONG64                          Reserved2;
    PVOID                            Reserved3;
    EX_POOL_PRIORITY                 Priority;
    POOL_EXTENDED_PARAMS_SECURE_POOL *SecurePoolParams;
    POOL_NODE_REQUIREMENT            PreferredNode;
  } DUMMYUNIONNAME;
} POOL_EXTENDED_PARAMETER, *PPOOL_EXTENDED_PARAMETER;

Membres

DUMMYSTRUCTNAME

DUMMYSTRUCTNAME.Type

Valeur d’énumération POOL_EXTENDED_PARAMETER_TYPE qui indique le type du paramètre.

Si cette valeur est définie sur PoolExtendedParameterPriority, le membre Priority de cette structure doit être une valeur EX_POOL_PRIORITY indiquant la priorité de l’allocation du pool. S’il n’y a pas suffisamment d’espace pour la priorité spécifiée, l’allocation échoue.

DUMMYSTRUCTNAME.Optional

Si ce champ est défini sur 1, le paramètre étendu est facultatif. Si type n’est pas une valeur d’énumération valide, elle est ignorée. Si type est une énumération valide, elle peut toujours être ignorée, par exemple si elle n’est pas compatible avec d’autres indicateurs spécifiés.

Si ce champ est défini sur 0, type doit être reconnu par l’allocateur de pool ou l’allocation échoue.

DUMMYSTRUCTNAME.Reserved

Réservé pour une utilisation ultérieure.

DUMMYUNIONNAME

DUMMYUNIONNAME.Reserved2

DUMMYUNIONNAME.Reserved3

DUMMYUNIONNAME.Priority

Si type a la valeur PoolExtendedParameterPriority, ce champ doit contenir une valeur de EX_POOL_PRIORITY valide.

DUMMYUNIONNAME.SecurePoolParams

DUMMYUNIONNAME.PreferredNode

Si Type est défini sur PoolExtendedParameterNumaNode ce champ doit contenir un index de nœud NUMA valide numéroté 0 à N-1. Si le champ contient également MM_ANY_NODE_OK, l’appel préfère le nœud NUMA spécifié, mais tente d’autres s’il n’est pas disponible. Si MM_ANY_NODE_OK n’est pas défini, l’appel échoue si le nœud NUMA demandé ne peut pas satisfaire l’allocation. Ce paramètre est valide uniquement pour les allocations effectuées avec POOL_FLAG_NON_PAGED pool.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 10, version 2004
d’en-tête	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)

Voir aussi

POOL_EXTENDED_PARAMETER_TYPE

ExAllocatePool3