POOL_EXTENDED_PARAMETER Struktur (wdm.h)
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) |