POOL_EXTENDED_PARAMETER struttura (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;

Members

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 Type 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, il tipo deve essere riconosciuto dall'allocatore del pool o l'allocazione ha esito negativo.

DUMMYSTRUCTNAME.Reserved

Riservato per utilizzi futuri.

DUMMYUNIONNAME

DUMMYUNIONNAME.Reserved2

DUMMYUNIONNAME.Reserved3

DUMMYUNIONNAME.Priority

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

DUMMYUNIONNAME.SecurePoolParams

DUMMYUNIONNAME.PreferredNode

Se Type è 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 riesce a soddisfare l'allocazione. Questo parametro è valido solo per le allocazioni effettuate con il pool di POOL_FLAG_NON_PAGED.

Requisiti

Vedi anche

POOL_EXTENDED_PARAMETER_TYPE

ExAllocatePool3