POOL_EXTENDED_PARAMETER Struktur (wdm.h)

  • Artikel

Gibt erweiterte Parameterinformationen an, die der Treiber beim Aufrufen von ExAllocatePool3 bereitstellt.

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;

Member

DUMMYSTRUCTNAME

DUMMYSTRUCTNAME.Type

Ein POOL_EXTENDED_PARAMETER_TYPE Enumerationswert, der den Typ des Parameters angibt.

Wenn dieser Wert auf PoolExtendedParameterPriority festgelegt ist, muss das Priority-Element 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 Enumeration ist, kann sie weiterhin ignoriert werden, z. B. wenn sie mit anderen angegebenen Flags nicht kompatibel ist.

Wenn dieses Feld auf 0 festgelegt ist, muss Type vom Poolzuordnungsgeber erkannt werden, andernfalls schlägt die Zuordnung fehl.

DUMMYSTRUCTNAME.Reserved

Für die zukünftige Verwendung reserviert.

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 Type auf PoolExtendedParameterNumaNode festgelegt ist, sollte dieses Feld einen gültigen NUMA-Knotenindex mit den Nummern 0 bis N-1 enthalten. Wenn das Feld auch MM_ANY_NODE_OK enthält, bevorzugt der Aufruf den angegebenen NUMA-Knoten, versucht jedoch andere, wenn er 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 gültig, die mit POOL_FLAG_NON_PAGED Pool vorgenommen werden.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 10, Version 2004
Header wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h)

Weitere Informationen

POOL_EXTENDED_PARAMETER_TYPE

ExAllocatePool3