次の方法で共有

FltCheckAndGrowNameControl 関数 (fltkernel.h)

  • [アーティクル]

FltCheckAndGrowNameControl ルーチンは、FLT_NAME_CONTROL 構造体内のバッファーが、指定したバイト数を保持するのに十分な大きさであるかどうかをチェックします。 そうでない場合は、FltCheckAndGrowNameControl 、より大きなシステム割り当てバッファーに置き換えられます。

構文

NTSTATUS FLTAPI FltCheckAndGrowNameControl(
  [in, out] PFLT_NAME_CONTROL NameCtrl,
  [in]      USHORT            NewSize
);

パラメーター

[in, out] NameCtrl

ファイル名情報を含む FLT_NAME_CONTROL 構造体へのポインター。

[in] NewSize

新しい名前制御バッファーの必要なサイズ (バイト単位)。

戻り値

FltCheckAndGrowNameControl は、STATUS_SUCCESSまたは次のような適切な NTSTATUS 値を返します。

リターン コード 形容
STATUS_INSUFFICIENT_RESOURCES
 空きプールには、要求を満たすメモリが不足しています。

備考

ミニフィルター ドライバーは、FLT_NAME_CONTROL 構造体の 名 メンバー内のバッファーを直接解放または置換しないでください。 代わりに、ミニフィルター ドライバーは FltCheckAndGrowNameControl 呼び出して、より大きな名前バッファーを取得する必要があります。

NameCtrl 構造体内のバッファーのサイズ (バイト単位) が、NewSize パラメーターの値より小さい場合、FltCheckAndGrowNameControl は、より大きなシステム割り当てバッファーに置き換。 FltCheckAndGrowNameControl 、古いバッファーの内容を新しいバッファーにコピーし、古いバッファーを解放します。

NameCtrl 構造体のバッファーのサイズが NewSize パラメーターの値以上の場合、FltCheckAndGrowNameControl はSTATUS_SUCCESSを返し、バッファーを置き換えません。

必要条件

要件 価値
ターゲット プラットフォーム の 万国
ヘッダー fltkernel.h (Fltkernel.h を含む)
ライブラリ FltMgr.lib
IRQL <= APC_LEVEL

関連項目

FLT_NAME_CONTROL

FltGetFileNameFormat の

FltGetFileNameInformation の

FltGetFileNameInformationUnsafe の

FltGetFileNameQueryMethod の