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)

另請參閱

POOL_EXTENDED_PARAMETER_TYPE

ExAllocatePool3