NtCreateSection 関数 (ntifs.h)

[アーティクル]
07/11/2023

NtCreateSection ルーチンは、セクションオブジェクト** を作成します。

構文

__kernel_entry NTSYSCALLAPI NTSTATUS NtCreateSection(
  [out]          PHANDLE            SectionHandle,
  [in]           ACCESS_MASK        DesiredAccess,
  [in, optional] POBJECT_ATTRIBUTES ObjectAttributes,
  [in, optional] PLARGE_INTEGER     MaximumSize,
  [in]           ULONG              SectionPageProtection,
  [in]           ULONG              AllocationAttributes,
  [in, optional] HANDLE             FileHandle
);

パラメーター

[out] SectionHandle

セクションオブジェクトへのハンドルを受け取る HANDLE 変数へのポインター。

[in] DesiredAccess

オブジェクトへの要求されたアクセスを決定する ACCESS_MASK 値を指定します。呼び出し元は、すべての種類のオブジェクトに対して定義されているアクセス権に加えて、セクションオブジェクトに固有の次のいずれかのアクセス権を指定できます。

DesiredAccess フラグ	呼び出し元がこれを行うことを許可します
SECTION_EXTEND_SIZE	セクションのサイズを動的に拡張します。
SECTION_MAP_EXECUTE	セクションのビューを実行します。
SECTION_MAP_READ	セクションのビューを読み取る。
SECTION_MAP_WRITE	セクションのビューを書き込みます。
SECTION_QUERY	セクションに関する情報をセクションオブジェクトに照会します。ドライバーは、このフラグを設定する必要があります。
SECTION_ALL_ACCESS	前のフラグはすべて、STANDARD_RIGHTS_REQUIREDと組み合わされます。

[in, optional] ObjectAttributes

オブジェクト名とその他の属性を指定する OBJECT_ATTRIBUTES 構造体へのポインター。 InitializeObjectAttributes を使用して、この構造体を初期化します。呼び出し元がシステムスレッドコンテキストで実行されていない場合は、 InitializeObjectAttributes を呼び出すときにOBJ_KERNEL_HANDLE属性を設定する必要があります。

[in, optional] MaximumSize

セクションの最大サイズをバイト単位で指定します。 NtCreateSection は、この値をPAGE_SIZEの最も近い倍数に切り上げます。セクションがページングファイルによってサポートされている場合、 MaximumSize はセクションの実際のサイズを指定します。セクションが通常のファイルでサポートされている場合、 MaximumSize は、ファイルを拡張またはマップできる最大サイズを指定します。

[in] SectionPageProtection

セクションの各ページに配置する保護を指定します。 PAGE_READONLY、PAGE_READWRITE、PAGE_EXECUTE、またはPAGE_WRITECOPYの 4 つの値のいずれかを使用します。これらの値の説明については、「 CreateFileMapping」を参照してください。

[in] AllocationAttributes

セクションの割り当て属性を決定するSEC_XXX フラグのビットマスクを指定します。これらのフラグの説明については、「 CreateFileMapping」を参照してください。

[in, optional] FileHandle

必要に応じて、開いているファイルオブジェクトのハンドルを指定します。 FileHandle の値が NULL の場合、セクションはページングファイルによってサポートされます。それ以外の場合、セクションは指定されたファイルによってサポートされます。

戻り値

NtCreateSection は 、成功した場合はSTATUS_SUCCESS、失敗した場合は適切な NTSTATUS エラーコードを返します。考えられるエラー状態コードは次のとおりです。

リターンコード	説明
STATUS_FILE_LOCK_CONFLICT	FileHandle パラメーターで指定されたファイルはロックされています。
STATUS_INVALID_FILE_FOR_SECTION	FileHandle で指定されたファイルは、セクションをサポートしていません。
STATUS_INVALID_PAGE_PROTECTION	SectionPageProtection パラメーターに指定された値が無効です。
STATUS_MAPPED_FILE_SIZE_ZERO	FileHandle で指定されたファイルのサイズは 0 で、MaximumSize は 0 です。
STATUS_SECTION_TOO_BIG	MaximumSize の値が大きすぎます。これは、 MaximumSize がセクションのシステム定義の最大値より大きい場合、または MaximumSize が指定されたファイルより大きく、セクションが書き込み可能でない場合に発生します。

注釈

SectionHandle が指すハンドルが使用されなくなったら、ドライバーは NtClose を呼び出して閉じる必要があります。

呼び出し元がシステムスレッドコンテキストで実行されていない場合は、作成するハンドルがプライベートハンドルであることを確認する必要があります。それ以外の場合は、ドライバーが実行されているコンテキスト内のプロセスによってハンドルにアクセスできます。詳細については、「オブジェクトハンドル」を参照してください。

マップされたセクションとメモリのビューの設定の詳細については、「セクションとビュー」を参照してください。

注意

この関数の呼び出しがユーザーモードで発生する場合は、"ZwCreateSection" ではなく "NtCreateSection" という名前を使用する必要があります。

カーネルモードドライバーからの呼び出しの場合、Windows ネイティブシステムサービスルーチンの NtXxx および ZwXxx バージョンは、入力パラメーターを処理および解釈する方法で動作が異なる場合があります。 ルーチンの NtXxx バージョンと ZwXxx バージョンの間の関係の詳細については、「ネイティブシステムサービスルーチンの Nt バージョンと Zw バージョンの使用」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows 2000。
対象プラットフォーム	ユニバーサル
Header	ntifs.h (Wdm.h、Ntifs.h を含む)
Library	NtosKrnl.lib
[DLL]	NtosKrnl.exe
IRQL	PASSIVE_LEVEL