estrutura POOL_EXTENDED_PARAMETER (wdm.h)

  • Artigo

Especifica informações de parâmetro estendido que o driver fornece ao chamar ExAllocatePool3.

Sintaxe

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;

Membros

DUMMYSTRUCTNAME

DUMMYSTRUCTNAME.Type

Um POOL_EXTENDED_PARAMETER_TYPE valor de enumeração que indica o tipo do parâmetro.

Se esse valor for definido como PoolExtendedParameterPriority, o membro Priority dessa estrutura deverá ser um valor EX_POOL_PRIORITY que indica a prioridade da alocação do pool. Se não houver espaço suficiente para a prioridade especificada, a alocação falhará.

DUMMYSTRUCTNAME.Optional

Se esse campo for definido como 1, o parâmetro estendido será opcional. Se Type não for um valor de enumeração válido, ele será ignorado. Se Type for uma enumeração válida, ele ainda poderá ser ignorado, por exemplo, se for incompatível com outros sinalizadores especificados.

Se esse campo estiver definido como 0, Type deverá ser reconhecido pelo alocador do pool ou a alocação falhará.

DUMMYSTRUCTNAME.Reserved

Reservado para uso futuro.

DUMMYUNIONNAME

DUMMYUNIONNAME.Reserved2

DUMMYUNIONNAME.Reserved3

DUMMYUNIONNAME.Priority

Se Type for definido como PoolExtendedParameterPriority, esse campo deverá conter um valor de EX_POOL_PRIORITY válido.

DUMMYUNIONNAME.SecurePoolParams

DUMMYUNIONNAME.PreferredNode

Se Type estiver definido como PoolExtendedParameterNumaNode , esse campo deverá conter um índice de nó NUMA válido numerado de 0 a N-1. Se o campo também contiver MM_ANY_NODE_OK, a chamada preferirá o nó NUMA especificado, mas tentará outras pessoas se não estiver disponível. Se MM_ANY_NODE_OK não estiver definido, a chamada falhará se o nó NUMA solicitado não puder atender à alocação. Esse parâmetro é válido apenas para alocações feitas com POOL_FLAG_NON_PAGED pool.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 10, versão 2004
Cabeçalho wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)

Confira também

POOL_EXTENDED_PARAMETER_TYPE

ExAllocatePool3