POOL_EXTENDED_PARAMETER structure (wdm.h)

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

Syntaxe

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 de pool. Si l’espace est insuffisant 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, il peut toujours être ignoré, par exemple s’il 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 un usage futur.

DUMMYUNIONNAME

DUMMYUNIONNAME.Reserved2

DUMMYUNIONNAME.Reserved3

DUMMYUNIONNAME.Priority

Si Type est défini sur PoolExtendedParameterPriority, ce champ doit contenir une valeur 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é de 0 à N-1. Si le champ contient également MM_ANY_NODE_OK, l’appel préfère le nœud NUMA spécifié, mais en essaie 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.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 10, version 2004
En-tête	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)

Voir aussi

POOL_EXTENDED_PARAMETER_TYPE

ExAllocatePool3