次の方法で共有


MemoryMappedFile.OpenExisting メソッド

定義

システム メモリ内で既存の名前付きメモリ マップト ファイルを開きます。

オーバーロード

OpenExisting(String)

システム メモリ内で名前が指定されたメモリ マップト ファイルを開きます。

OpenExisting(String, MemoryMappedFileRights)

システム メモリ内で名前およびアクセス権が指定されたメモリ マップト ファイルを開きます。

OpenExisting(String, MemoryMappedFileRights, HandleInheritability)

システム メモリ内で名前、アクセス権、および継承性が指定されたメモリ マップト ファイルを開きます。

OpenExisting(String)

ソース:
MemoryMappedFile.cs
ソース:
MemoryMappedFile.cs
ソース:
MemoryMappedFile.cs

システム メモリ内で名前が指定されたメモリ マップト ファイルを開きます。

public:
 static System::IO::MemoryMappedFiles::MemoryMappedFile ^ OpenExisting(System::String ^ mapName);
[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static System.IO.MemoryMappedFiles.MemoryMappedFile OpenExisting (string mapName);
public static System.IO.MemoryMappedFiles.MemoryMappedFile OpenExisting (string mapName);
[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member OpenExisting : string -> System.IO.MemoryMappedFiles.MemoryMappedFile
static member OpenExisting : string -> System.IO.MemoryMappedFiles.MemoryMappedFile
Public Shared Function OpenExisting (mapName As String) As MemoryMappedFile

パラメーター

mapName
String

メモリ マップト ファイルの名前。

戻り値

指定された名前を持つメモリ マップト ファイル。

属性

例外

mapNamenullです。

mapName が空の文字列です。

mapName に指定されたファイルが存在しません。

永続化された Memory-Mapped ファイルを開く

次の例では、 メソッドの例に示すように、ディスク上のファイルから既に作成されている という名前 ImgA のメモリ マップト ファイルを CreateFromFile(String) 開きます。

using System;
using System.IO.MemoryMappedFiles;
using System.Runtime.InteropServices;

class Program
{
    static void Main(string[] args)
    {
        // Assumes another process has created the memory-mapped file.
        using (var mmf = MemoryMappedFile.OpenExisting("ImgA"))
        {
            using (var accessor = mmf.CreateViewAccessor(4000000, 2000000))
            {
                int colorSize = Marshal.SizeOf(typeof(MyColor));
                MyColor color;

                // Make changes to the view.
                for (long i = 0; i < 1500000; i += colorSize)
                {
                    accessor.Read(i, out color);
                    color.Brighten(20);
                    accessor.Write(i, ref color);
                }
            }
        }
    }
}

public struct MyColor
{
    public short Red;
    public short Green;
    public short Blue;
    public short Alpha;

    // Make the view brigher.
    public void Brighten(short value)
    {
        Red = (short)Math.Min(short.MaxValue, (int)Red + value);
        Green = (short)Math.Min(short.MaxValue, (int)Green + value);
        Blue = (short)Math.Min(short.MaxValue, (int)Blue + value);
        Alpha = (short)Math.Min(short.MaxValue, (int)Alpha + value);
    }
}
Imports System.IO.MemoryMappedFiles
Imports System.Runtime.InteropServices

Class Program
    Public Shared Sub Main(ByVal args As String())
        ' Assumes another process has created the memory-mapped file.
        Using mmf = MemoryMappedFile.OpenExisting("ImgA")
            Using accessor = mmf.CreateViewAccessor(4000000, 2000000)
                Dim colorSize As Integer = Marshal.SizeOf(GetType(MyColor))
                Dim color As MyColor

                ' Make changes to the view.
                Dim i As Long = 0
                While i < 1500000
                    accessor.Read(i, color)
                    color.Brighten(30)
                    accessor.Write(i, color)
                    i += colorSize
                End While
            End Using
        End Using
    End Sub
End Class

Public Structure MyColor
    Public Red As Short
    Public Green As Short
    Public Blue As Short
    Public Alpha As Short

    ' Make the view brigher.
    Public Sub Brighten(ByVal value As Short)
        Red = CShort(Math.Min(Short.MaxValue, CInt(Red) + value))
        Green = CShort(Math.Min(Short.MaxValue, CInt(Green) + value))
        Blue = CShort(Math.Min(Short.MaxValue, CInt(Blue) + value))
        Alpha = CShort(Math.Min(Short.MaxValue, CInt(Alpha) + value))
    End Sub
End Structure

永続化されていない Memory-Mapped ファイルを開く

次の例では、プロセス間通信に使用されるメモリ マップト ファイルを開きます。 このコード例は、 メソッドに対して提供されるより大きな例の CreateNew(String, Int64) 一部です。

注釈

メモリ マップト ファイルは、永続化されたメモリ マップト ファイル (ディスク上のファイルに関連付けられている) または非永続化のいずれかです。

こちらもご覧ください

適用対象

OpenExisting(String, MemoryMappedFileRights)

ソース:
MemoryMappedFile.cs
ソース:
MemoryMappedFile.cs
ソース:
MemoryMappedFile.cs

システム メモリ内で名前およびアクセス権が指定されたメモリ マップト ファイルを開きます。

public:
 static System::IO::MemoryMappedFiles::MemoryMappedFile ^ OpenExisting(System::String ^ mapName, System::IO::MemoryMappedFiles::MemoryMappedFileRights desiredAccessRights);
[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static System.IO.MemoryMappedFiles.MemoryMappedFile OpenExisting (string mapName, System.IO.MemoryMappedFiles.MemoryMappedFileRights desiredAccessRights);
public static System.IO.MemoryMappedFiles.MemoryMappedFile OpenExisting (string mapName, System.IO.MemoryMappedFiles.MemoryMappedFileRights desiredAccessRights);
[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member OpenExisting : string * System.IO.MemoryMappedFiles.MemoryMappedFileRights -> System.IO.MemoryMappedFiles.MemoryMappedFile
static member OpenExisting : string * System.IO.MemoryMappedFiles.MemoryMappedFileRights -> System.IO.MemoryMappedFiles.MemoryMappedFile
Public Shared Function OpenExisting (mapName As String, desiredAccessRights As MemoryMappedFileRights) As MemoryMappedFile

パラメーター

mapName
String

開くメモリ マップト ファイルの名前。

desiredAccessRights
MemoryMappedFileRights

メモリ マップト ファイルに適用するアクセス権を指定する列挙値の 1 つ。

戻り値

指定された特性を持つメモリ マップト ファイル。

属性

例外

mapNamenull です。

mapName が空の文字列です。

desiredAccessRights が有効な MemoryMappedFileRights 列挙値ではありません。

mapName に指定されたファイルが存在しません。

こちらもご覧ください

適用対象

OpenExisting(String, MemoryMappedFileRights, HandleInheritability)

ソース:
MemoryMappedFile.cs
ソース:
MemoryMappedFile.cs
ソース:
MemoryMappedFile.cs

システム メモリ内で名前、アクセス権、および継承性が指定されたメモリ マップト ファイルを開きます。

public:
 static System::IO::MemoryMappedFiles::MemoryMappedFile ^ OpenExisting(System::String ^ mapName, System::IO::MemoryMappedFiles::MemoryMappedFileRights desiredAccessRights, System::IO::HandleInheritability inheritability);
[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static System.IO.MemoryMappedFiles.MemoryMappedFile OpenExisting (string mapName, System.IO.MemoryMappedFiles.MemoryMappedFileRights desiredAccessRights, System.IO.HandleInheritability inheritability);
public static System.IO.MemoryMappedFiles.MemoryMappedFile OpenExisting (string mapName, System.IO.MemoryMappedFiles.MemoryMappedFileRights desiredAccessRights, System.IO.HandleInheritability inheritability);
[System.Security.SecurityCritical]
public static System.IO.MemoryMappedFiles.MemoryMappedFile OpenExisting (string mapName, System.IO.MemoryMappedFiles.MemoryMappedFileRights desiredAccessRights, System.IO.HandleInheritability inheritability);
[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member OpenExisting : string * System.IO.MemoryMappedFiles.MemoryMappedFileRights * System.IO.HandleInheritability -> System.IO.MemoryMappedFiles.MemoryMappedFile
static member OpenExisting : string * System.IO.MemoryMappedFiles.MemoryMappedFileRights * System.IO.HandleInheritability -> System.IO.MemoryMappedFiles.MemoryMappedFile
[<System.Security.SecurityCritical>]
static member OpenExisting : string * System.IO.MemoryMappedFiles.MemoryMappedFileRights * System.IO.HandleInheritability -> System.IO.MemoryMappedFiles.MemoryMappedFile
Public Shared Function OpenExisting (mapName As String, desiredAccessRights As MemoryMappedFileRights, inheritability As HandleInheritability) As MemoryMappedFile

パラメーター

mapName
String

開くメモリ マップト ファイルの名前。

desiredAccessRights
MemoryMappedFileRights

メモリ マップト ファイルに適用するアクセス権を指定する列挙値の 1 つ。

inheritability
HandleInheritability

メモリ マップト ファイルへのハンドルを子プロセスが継承できるかどうかを指定する列挙値の 1 つ。 既定値は、None です。

戻り値

指定された特性を持つメモリ マップト ファイル。

属性

例外

mapNamenull です。

mapName が空の文字列です。

desiredAccessRights が有効な MemoryMappedFileRights 列挙値ではありません。

- または -

inheritability が有効な HandleInheritability 列挙値ではありません。

要求されたアクセスは、メモリ マップト ファイルに対して無効です。

mapName に指定されたファイルが存在しません。

こちらもご覧ください

適用対象