POOL_EXTENDED_PARAMETER 結構 (wdm.h)
指定驅動程式在呼叫 ExAllocatePool3 時所提供的擴充參數資訊。
語法
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;
成員
DUMMYSTRUCTNAME
DUMMYSTRUCTNAME.Type
指出參數類型的 POOL_EXTENDED_PARAMETER_TYPE 列舉值。
如果此值設定為 PoolExtendedParameterPriority,則這個結構的 Priority 成員必須是 EX_POOL_PRIORITY 值,指出集區配置的優先順序。 如果指定的優先順序沒有足夠的空間,則配置會失敗。
DUMMYSTRUCTNAME.Optional
如果此欄位設定為 1,則擴充參數是選擇性的。 如果 Type 不是有效的列舉值,則會忽略它。 如果 Type 是有效的列舉,可能仍會被忽略,例如,如果它與其他指定的旗標不相容。
如果此欄位設定為 0,則必須由集區配置器辨識 Type ,否則配置會失敗。
DUMMYSTRUCTNAME.Reserved
保留供未來使用。
DUMMYUNIONNAME
DUMMYUNIONNAME.Reserved2
DUMMYUNIONNAME.Reserved3
DUMMYUNIONNAME.Priority
如果 Type 設定為 PoolExtendedParameterPriority,此欄位必須包含有效的 EX_POOL_PRIORITY 值。
DUMMYUNIONNAME.SecurePoolParams
DUMMYUNIONNAME.PreferredNode
如果 Type 設定為 PoolExtendedParameterNumaNode ,此欄位應包含編號為 0 到 N-1 的有效 NUMA 節點索引。 如果欄位也包含MM_ANY_NODE_OK,則呼叫偏好指定的 NUMA 節點,但如果無法使用,則會嘗試其他節點。 如果未設定MM_ANY_NODE_OK,如果要求的 NUMA 節點無法滿足配置,呼叫就會失敗。 此參數僅適用於使用 POOL_FLAG_NON_PAGED 集區所做的配置。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 10 (版本 2004) |
標頭 | wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h) |