Freigeben über


POOL_EXTENDED_PARAMETER Struktur (wdm.h)

Gibt erweiterte Parameterinformationen an, die der Treiber beim Aufrufen ExAllocatePool3bereitstellt.

Syntax

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;

Angehörige

DUMMYSTRUCTNAME

DUMMYSTRUCTNAME.Type

Ein POOL_EXTENDED_PARAMETER_TYPE Enumerationswert, der den Typ des Parameters angibt.

Wenn dieser Wert auf PoolExtendedParameterPriorityfestgelegt ist, muss der Priority Member dieser Struktur ein EX_POOL_PRIORITY Wert sein, der die Priorität der Poolzuordnung angibt. Wenn nicht genügend Speicherplatz für die angegebene Priorität vorhanden ist, schlägt die Zuordnung fehl.

DUMMYSTRUCTNAME.Optional

Wenn dieses Feld auf 1 festgelegt ist, ist der erweiterte Parameter optional. Wenn Type kein gültiger Enumerationswert ist, wird er ignoriert. Wenn Type eine gültige Aufzählung ist, wird sie möglicherweise weiterhin ignoriert, z. B. wenn sie nicht mit anderen angegebenen Flags kompatibel ist.

Wenn dieses Feld auf 0 festgelegt ist, muss Typ- vom Poolverteiler erkannt werden, oder die Zuordnung schlägt fehl.

DUMMYSTRUCTNAME.Reserved

Reserviert für die zukünftige Verwendung.

DUMMYUNIONNAME

DUMMYUNIONNAME.Reserved2

DUMMYUNIONNAME.Reserved3

DUMMYUNIONNAME.Priority

Wenn Type auf PoolExtendedParameterPriority-festgelegt ist, muss dieses Feld einen gültigen EX_POOL_PRIORITY Wert enthalten.

DUMMYUNIONNAME.SecurePoolParams

DUMMYUNIONNAME.PreferredNode

Wenn Typ- auf PoolExtendedParameterNumaNode festgelegt ist, sollte dieses Feld einen gültigen NUMA-Knotenindex mit der Nummer 0 bis N-1 enthalten. Wenn das Feld auch MM_ANY_NODE_OK enthält, bevorzugt der Aufruf den angegebenen NUMA-Knoten, versucht aber, wenn es nicht verfügbar ist. Wenn MM_ANY_NODE_OK nicht festgelegt ist, schlägt der Aufruf fehl, wenn der angeforderte NUMA-Knoten die Zuordnung nicht erfüllen kann. Dieser Parameter ist nur für Zuordnungen mit POOL_FLAG_NON_PAGED Pool gültig.

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Windows 10, Version 2004
Header- wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)

Siehe auch

POOL_EXTENDED_PARAMETER_TYPE

ExAllocatePool3