POOL_CREATE_EXTENDED_PARAMS 構造体を定義します。
構文
typedef struct _POOL_CREATE_EXTENDED_PARAMS {
ULONG Version;
ULONG ParameterCount;
PPOOL_CREATE_EXTENDED_PARAMETER Parameters;
} POOL_CREATE_EXTENDED_PARAMS, *PPOOL_CREATE_EXTENDED_PARAMS;
メンバーズ
Version
この構造体のバージョンを指定する ULONG。 POOL_CREATE_PARAMS_VERSION (現在は 1) に設定します。 その他の値を指定すると、 ExCreatePool は STATUS_INVALID_PARAMETERで失敗します。 将来のバージョンでは、この構造が拡張される可能性があります。ドライバーは常にこのフィールドを明示的に初期化する必要があります。
ParameterCount
Parameters が指す配列内の要素の数。 拡張パラメーターを指定しない場合は、0 にする必要があります。
Parameters
追加の作成パラメーターを提供 するPOOL_CREATE_EXTENDED_PARAMETER エントリの配列へのポインター。 ParameterCount が 0 の場合は NULL にする必要があります。 各エントリの Type フィールドは、パラメーターの種類を識別します。 現在、有効な型は PoolCreateExtendedParameterName のみです。 PoolName メンバーにプールの Unicode 名を指定します。 名前は、作成するドライバー コンテキスト内で一意であり、内部の名前付け制約に従う必要があります。 サポートされていないパラメーター型または重複するパラメーター型は拒否されます。
注釈
この構造体を使用して、省略可能 (または必須) の拡張作成データを Params 引数を使用して ExCreatePool に渡します。
ページングされたプライベート プールと非ページ プライベート プールでは、名前パラメーターを 1 つだけ指定する必要があります。 セキュリティで保護されたプールでは、名前パラメーターを指定しないでください。
ParameterCount が 0 以外の場合、Parameters は、その多くのエントリの有効で読み取り可能な配列を指す必要があります。
カーネルによって認識されないパラメーター型または複数回出現すると 、ExCreatePool は STATUS_INVALID_PARAMETER_3を返します。
構造は、前方互換性を可能にするためにバージョン管理されています。ドライバーは、将来のリリースで追加のフィールドがゼロのままであると想定しないでください。認識できない拡張機能を解釈する前に常にバージョンを確認してください (バッファーが別の場所から読み取られた場合)。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小サーバー | Windows Server 2022 |
| ヘッダー | wdm.h (Wdm.h を含む) |