Compartilhar via


estrutura POOL_EXTENDED_PARAMETER (wdm.h)

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 valor de enumeração POOL_EXTENDED_PARAMETER_TYPE que indica o tipo do parâmetro.

Se esse valor for definido como PoolExtendedParameterPriority, o membro de Prioridade dessa estrutura deverá ser um valor EX_POOL_PRIORITY indicando 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 Tipo não for um valor de enumeração válido, ele será ignorado. Se Tipo for uma enumeração válida, ela ainda poderá ser ignorada, por exemplo, se for incompatível com outros sinalizadores especificados.

Se esse campo for definido como 0, Tipo 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 estiver definido como PoolExtendedParameterPriority, esse campo deverá conter um valor de EX_POOL_PRIORITY válido.

DUMMYUNIONNAME.SecurePoolParams

DUMMYUNIONNAME.PreferredNode

Se Type for definido como PoolExtendedParameterNumaNode esse campo deverá conter um índice numérico 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
de cliente com suporte mínimo Windows 10, versão 2004
cabeçalho wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)

Consulte também

POOL_EXTENDED_PARAMETER_TYPE

ExAllocatePool3