Condividi tramite


struttura POOL_EXTENDED_PARAMETER (wdm.h)

Specifica le informazioni sui parametri estese fornite dal driver quando si chiama ExAllocatePool3.

Sintassi

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;

Membri

DUMMYSTRUCTNAME

DUMMYSTRUCTNAME.Type

Valore di enumerazione POOL_EXTENDED_PARAMETER_TYPE che indica il tipo del parametro.

Se questo valore è impostato su PoolExtendedParameterPriority, il membro Priority di questa struttura deve essere un valore EX_POOL_PRIORITY che indica la priorità dell'allocazione del pool. Se non è disponibile spazio sufficiente per la priorità specificata, l'allocazione ha esito negativo.

DUMMYSTRUCTNAME.Optional

Se questo campo è impostato su 1, il parametro esteso è facoltativo. Se Tipo non è un valore di enumerazione valido, viene ignorato. Se Type è un'enumerazione valida, può comunque essere ignorata, ad esempio se non è compatibile con altri flag specificati.

Se questo campo è impostato su 0, Tipo deve essere riconosciuto dall'allocatore del pool o l'allocazione non riesce.

DUMMYSTRUCTNAME.Reserved

Riservato per uso futuro.

DUMMYUNIONNAME

DUMMYUNIONNAME.Reserved2

DUMMYUNIONNAME.Reserved3

DUMMYUNIONNAME.Priority

Se Tipo è impostato su PoolExtendedParameterPriority, questo campo deve contenere un valore EX_POOL_PRIORITY valido.

DUMMYUNIONNAME.SecurePoolParams

DUMMYUNIONNAME.PreferredNode

Se Tipo è impostato su PoolExtendedParameterNumaNode questo campo deve contenere un indice di nodo NUMA valido numerato da 0 a N-1. Se il campo contiene anche MM_ANY_NODE_OK, la chiamata preferisce il nodo NUMA specificato, ma prova altri se non è disponibile. Se MM_ANY_NODE_OK non è impostato, la chiamata ha esito negativo se il nodo NUMA richiesto non può soddisfare l'allocazione. Questo parametro è valido solo per le allocazioni effettuate con POOL_FLAG_NON_PAGED pool.

Fabbisogno

Requisito Valore
client minimo supportato Windows 10, versione 2004
intestazione wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)

Vedere anche

POOL_EXTENDED_PARAMETER_TYPE

exAllocatePool3