MapViewOfFile 関数 (memoryapi.h)
ファイル マッピングのビューを呼び出し元プロセスのアドレス空間にマップします。
ビューの推奨ベース アドレスを指定するには、 MapViewOfFileEx 関数を使用します。 ただし、この方法はお勧めしません。
構文
LPVOID MapViewOfFile(
[in] HANDLE hFileMappingObject,
[in] DWORD dwDesiredAccess,
[in] DWORD dwFileOffsetHigh,
[in] DWORD dwFileOffsetLow,
[in] SIZE_T dwNumberOfBytesToMap
);
パラメーター
[in] hFileMappingObject
ファイル マッピング オブジェクトへのハンドル。 CreateFileMapping 関数と OpenFileMapping 関数は、このハンドルを返します。
[in] dwDesiredAccess
ページのページ保護を決定するファイル マッピング オブジェクトへのアクセスの種類。 このパラメーターには、次の値のいずれか、または必要に応じて複数の値のビットごとの OR の組み合わせを指定できます。
ビットごとの OR を使用すると、上記の値とこれらの値を組み合わせることができます。
| 値 | 説明 |
|---|---|
|
ファイルの書き込み時のコピー ビューがマップされます。 ファイル マッピング オブジェクトは、 PAGE_READONLY、 PAGE_READ_EXECUTE、PAGE_WRITECOPY、 PAGE_EXECUTE_WRITECOPY、 PAGE_READWRITE、または PAGE_EXECUTE_READWRITE保護を使用 して 作成されている必要があります。
プロセスが書き込み時のコピー ページに書き込むと、システムは元のページをプロセスにプライベートな新しいページにコピーします。 新しいページはページング ファイルによってサポートされます。 新しいページの保護は、書き込み時のコピーから読み取り/書き込みに変わります。 書き込み時のコピー アクセスを指定すると、呼び出し元のプロセスがビュー内のすべてのページに書き込み、すべてのページをプライベートにできるため、システムとプロセスのコミット料金はビュー全体に対するものです。 新しいページの内容は元のファイルに書き戻されることはなく、ビューがマップ解除されると失われます。 |
|
ファイルの実行可能ビューがマップされます (マップされたメモリはコードとして実行できます)。 ファイル マッピング オブジェクトは、 PAGE_EXECUTE_READ、PAGE_EXECUTE_WRITECOPY、または PAGE_EXECUTE_READWRITE保護を使用 して 作成されている必要があります。
Windows Server 2003 および Windows XP: この値は、SP2 と Windows Server 2003 SP1 の Windows XP 以降で使用できます。 |
|
バージョン 1703 Windows 10以降、このフラグは、大きなページ サポートを使用してビューをマップする必要があることを指定します。 ビューのサイズは 、GetLargePageMinimum 関数によって報告される大きなページのサイズの倍数である必要があり、ファイル マッピング オブジェクトは SEC_LARGE_PAGES オプションを使用して作成されている必要があります。 lpBaseAddress に null 以外の値を指定する場合、値は GetLargePageMinimum の倍数である必要があります。 メモ： Windows 10バージョン 1703 より前の OS バージョンでは、FILE_MAP_LARGE_PAGES フラグは無効です。 これらのリリースでは、セクションが SEC_LARGE_PAGES フラグ セットで作成された場合、ビューは大きなページを使用して自動的 に マップされます。 |
|
マップされたファイル内のすべての場所を、制御フロー ガード (CFG) の無効なターゲットとして設定します。 このフラグは 、PAGE_TARGETS_INVALIDに似ています。 このフラグは、実行アクセス権FILE_MAP_EXECUTEと組み合わせて使用 します。 これらのページ内の場所に対する間接呼び出しは CFG チェックに失敗し、プロセスは終了します。 割り当てられた実行可能ページの既定の動作は、CFG の有効な呼び出しターゲットとしてマークされます。 |
SEC_IMAGE属性を使用して作成されたファイル マッピング オブジェクトの場合、dwDesiredAccess パラメーターは無効であり、FILE_MAP_READなどの有効な値に設定する必要があります。
ファイル マッピング オブジェクトへのアクセスの詳細については、「 ファイル マッピング のセキュリティとアクセス権」を参照してください。
[in] dwFileOffsetHigh
ビューが開始するファイル オフセットの高次 DWORD 。
[in] dwFileOffsetLow
ビューを開始するファイル オフセットの下位 DWORD 。 高オフセットと低オフセットの組み合わせは、ファイル マッピング内のオフセットを指定する必要があります。 また、システムのメモリ割り当て粒度と一致する必要もあります。 つまり、オフセットは割り当て粒度の倍数である必要があります。 システムのメモリ割り当て粒度を取得するには、 GetSystemInfo 関数を使用します。この関数は、 SYSTEM_INFO 構造体のメンバーを格納します。
[in] dwNumberOfBytesToMap
ビューにマップするファイル マッピングのバイト数。 すべてのバイトは、 CreateFileMapping で指定された最大サイズ内にある必要があります。 このパラメーターが 0 (ゼロ) の場合、マッピングは指定されたオフセットからファイル マッピングの末尾まで拡張されます。
戻り値
関数が成功した場合、戻り値はマップされたビューの開始アドレスです。
関数が失敗した場合は、返される値は NULL です。 詳細なエラー情報を得るには、GetLastError を呼び出します。
解説
ファイルをマッピングすると、ファイルの指定された部分が呼び出し元プロセスのアドレス空間に表示されます。
アドレス空間より大きいファイルの場合、ファイル データのごく一部のみを一度にマップできます。 最初のビューが完了したら、マップを解除して新しいビューをマップできます。
ビューのサイズを取得するには、 VirtualQuery 関数を使用します。
ファイルの複数のビュー (またはファイル マッピング オブジェクトとそのマップされたファイル) は、指定された時刻に同じデータが含まれている場合に 一貫性 があります。 これは、ファイル ビューが、同じファイルによってサポートされているファイル マッピング オブジェクトから派生した場合に発生します。 プロセスでは、 DuplicateHandle 関数を使用してファイル マッピング オブジェクト ハンドルを別のプロセスに複製するか、別のプロセスで OpenFileMapping 関数を使用してファイル マッピング オブジェクトを名前で開くことができます。
1 つの重要な例外では、同じファイルによってサポートされるファイル マッピング オブジェクトから派生したファイル ビューは、特定の時点で一貫性または同一です。 一貫性は、プロセス内のビューと、異なるプロセスによってマップされるビューに対して保証されます。
例外はリモート ファイルに関連しています。 MapViewOfFile はリモート ファイルで動作しますが、一貫性を保つことはありません。 たとえば、2 台のコンピューターが両方ともファイルを書き込み可能としてマップし、両方が同じページを変更した場合、各コンピューターはページへの独自の書き込みのみを表示します。 データがディスク上で更新されると、マージされません。
ファイルのマップされたビューは、 ReadFile 関数または WriteFile 関数によってアクセスされるファイルと一貫性があるとは限りません。
メモリ マップファイルにポインターを格納しないでください。は、任意のアドレスでマッピングを使用できるように、ファイル マッピングのベースからのオフセットを格納します。
EXCEPTION_IN_PAGE_ERROR例外から保護するには、構造化例外処理を使用して、ページ ファイル以外のファイルのメモリ マップ ビューに対して書き込みまたは読み取りを行うコードを保護します。 詳細については、「 ファイル ビューからの読み取りと書き込み」を参照してください。
マップされたビューを使用してファイルを変更する場合、最後の変更タイムスタンプが自動的に更新されない場合があります。 必要に応じて、呼び出し元は SetFileTime を使用してタイムスタンプを設定する必要があります。
ページング ファイルによってファイル マッピング オブジェクトがサポートされている場合 (CreateFileMapping は hFile パラメーターを INVALID_HANDLE_VALUE に設定して呼び出されます)、ページング ファイルはマッピング全体を保持するのに十分な大きさである必要があります。 そうでない場合、 MapViewOfFile は 失敗します。 ページング ファイルによってサポートされるファイル マッピング オブジェクト内のページの初期内容は 0 (ゼロ) です。
ページング ファイルによってサポートされるファイル マッピング オブジェクトが作成されると、呼び出し元は MapViewOfFile でページを同時に予約してコミットするか (SEC_COMMIT) するか、単にページを予約するか (SEC_RESERVE) を指定できます。 ファイルをマッピングすると、マップされた仮想アドレス範囲全体がプロセス内の他の割り当てに使用できなくなります。 予約範囲のページがコミットされた後、 VirtualFree を呼び出して解放またはコミット解除することはできません。 予約済みページとコミット済みページは、ビューがマップ解除され、ファイル マッピング オブジェクトが閉じられると解放されます。 詳細については、 UnmapViewOfFile 関数と CloseHandle 関数を参照してください。
実行可能なアクセス許可を持つファイルを取得するには、アプリケーションで PAGE_EXECUTE_READWRITE または PAGE_EXECUTE_READ で CreateFileMapping を呼び出し、FILE_MAP_EXECUTE FILE_MAP_WRITEまたはFILE_MAP_EXECUTE | FILE_MAP_READを使用して | MapViewOfFile を呼び出す必要があります。
Windows Server 2012 では、この関数は次のテクノロジでサポートされています。
| テクノロジ | サポートされています |
|---|---|
| サーバー メッセージ ブロック (SMB) 3.0 プロトコル | はい |
| SMB 3.0 Transparent Failover (TFO) | はい |
| スケールアウト ファイル共有 (SO) を使う SMB 3.0 | はい |
| クラスターの共有ボリューム ファイル システム (CsvFS) | はい |
| Resilient File System (ReFS) | はい |
CsvFs を一時停止すると、ロックの競合があることを示すエラーでこの呼び出しが失敗する可能性があります。
例
例については、「 名前付き共有メモリの作成」を参照してください。
要件
| サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| 対象プラットフォーム | Windows |
| ヘッダー | memoryapi.h (Windows.h、Memoryapi.h を含む) |
| Library | onecore.lib |
| [DLL] | Kernel32.dll |