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
Header wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む)

こちらもご覧ください

POOL_EXTENDED_PARAMETER_TYPE

ExAllocatePool3