estructura POOL_EXTENDED_PARAMETER (wdm.h)

  • Artículo

Especifica la información de parámetro extendida que proporciona el controlador al llamar a ExAllocatePool3.

Sintaxis

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;

Miembros

DUMMYSTRUCTNAME

DUMMYSTRUCTNAME.Type

Valor de enumeración POOL_EXTENDED_PARAMETER_TYPE que indica el tipo del parámetro.

Si este valor se establece en PoolExtendedParameterPriority, el miembro Priority de esta estructura debe ser un valor de EX_POOL_PRIORITY que indica la prioridad de la asignación del grupo. Si no hay suficiente espacio para la prioridad especificada, se produce un error en la asignación.

DUMMYSTRUCTNAME.Optional

Si este campo se establece en 1, el parámetro extendido es opcional. Si Type no es un valor de enumeración válido, se omite. Si Type es una enumeración válida, puede omitirse, por ejemplo, si no es compatible con otras marcas especificadas.

Si este campo se establece en 0, el asignador de grupo debe reconocer el tipo o se produce un error en la asignación.

DUMMYSTRUCTNAME.Reserved

Reservado para uso futuro.

DUMMYUNIONNAME

DUMMYUNIONNAME.Reserved2

DUMMYUNIONNAME.Reserved3

DUMMYUNIONNAME.Priority

Si Type se establece en PoolExtendedParameterPriority, este campo debe contener un valor de EX_POOL_PRIORITY válido.

DUMMYUNIONNAME.SecurePoolParams

DUMMYUNIONNAME.PreferredNode

Si Type se establece en PoolExtendedParameterNumaNode , este campo debe contener un índice de nodo NUMA válido numerado de 0 a N-1. Si el campo también contiene MM_ANY_NODE_OK, la llamada prefiere el nodo NUMA especificado, pero intenta otros si no está disponible. Si no se establece MM_ANY_NODE_OK, se produce un error en la llamada si el nodo NUMA solicitado no puede satisfacer la asignación. Este parámetro solo es válido para las asignaciones realizadas con POOL_FLAG_NON_PAGED grupo.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 10, versión 2004
Encabezado wdm.h (incluya Wdm.h, Ntddk.h, Ntifs.h)

Consulte también

POOL_EXTENDED_PARAMETER_TYPE

ExAllocatePool3