filemap.c File Reference

#include <k32.h>
#include <debug.h>

Include dependency graph for filemap.c:

Go to the source code of this file.

Macros
#define	NDEBUG

Functions
HANDLE NTAPI	CreateFileMappingA (IN HANDLE hFile, IN LPSECURITY_ATTRIBUTES lpFileMappingAttributes, IN DWORD flProtect, IN DWORD dwMaximumSizeHigh, IN DWORD dwMaximumSizeLow, IN LPCSTR lpName)
HANDLE NTAPI	CreateFileMappingW (HANDLE hFile, LPSECURITY_ATTRIBUTES lpFileMappingAttributes, DWORD flProtect, DWORD dwMaximumSizeHigh, DWORD dwMaximumSizeLow, LPCWSTR lpName)
LPVOID NTAPI	MapViewOfFileEx (HANDLE hFileMappingObject, DWORD dwDesiredAccess, DWORD dwFileOffsetHigh, DWORD dwFileOffsetLow, SIZE_T dwNumberOfBytesToMap, LPVOID lpBaseAddress)
LPVOID NTAPI	MapViewOfFile (HANDLE hFileMappingObject, DWORD dwDesiredAccess, DWORD dwFileOffsetHigh, DWORD dwFileOffsetLow, SIZE_T dwNumberOfBytesToMap)
BOOL NTAPI	UnmapViewOfFile (LPCVOID lpBaseAddress)
HANDLE NTAPI	OpenFileMappingA (IN DWORD dwDesiredAccess, IN BOOL bInheritHandle, IN LPCSTR lpName)
HANDLE NTAPI	OpenFileMappingW (IN DWORD dwDesiredAccess, IN BOOL bInheritHandle, IN LPCWSTR lpName)
BOOL NTAPI	FlushViewOfFile (IN LPCVOID lpBaseAddress, IN SIZE_T dwNumberOfBytesToFlush)

Macro Definition Documentation

NDEBUG

#define NDEBUG

Definition at line 13 of file filemap.c.

Function Documentation

CreateFileMappingA()

HANDLE NTAPI CreateFileMappingA	(	IN HANDLE	hFile,
		IN LPSECURITY_ATTRIBUTES	lpFileMappingAttributes,
		IN DWORD	flProtect,
		IN DWORD	dwMaximumSizeHigh,
		IN DWORD	dwMaximumSizeLow,
		IN LPCSTR	lpName
	)

Definition at line 23 of file filemap.c.

{
    /* Call the W(ide) function */
    ConvertWin32AnsiObjectApiToUnicodeApi(FileMapping,
                                          lpName,
                                          hFile,
                                          lpFileMappingAttributes,
                                          flProtect,
                                          dwMaximumSizeHigh,
                                          dwMaximumSizeLow);
}

Referenced by check_exe(), CloseEnhMetaFile(), DPLAYX_ConstructData(), EMF_GetEnhMetaFile(), IDirectXFileImpl_CreateEnumObject(), load_font(), main(), map_file(), MapAndLoad(), SHAllocShared(), START_TEST(), test_CreateFileMapping(), test_dde(), test_file_disposition_information(), test_file_sharing(), test_filemap_security(), test_GetMappedFileName(), test_MapFile(), test_MapViewOfFile(), test_name_collisions(), test_NtAreMappedFilesTheSame(), test_NtMapViewOfSection(), test_NtQuerySection(), test_shared_memory(), test_shared_memory_ro(), and VirtualTest().

CreateFileMappingW()

HANDLE NTAPI CreateFileMappingW	(	HANDLE	hFile,
		LPSECURITY_ATTRIBUTES	lpFileMappingAttributes,
		DWORD	flProtect,
		DWORD	dwMaximumSizeHigh,
		DWORD	dwMaximumSizeLow,
		LPCWSTR	lpName
	)

Definition at line 45 of file filemap.c.

{
    NTSTATUS Status;
    HANDLE SectionHandle;
    OBJECT_ATTRIBUTES LocalAttributes;
    POBJECT_ATTRIBUTES ObjectAttributes;
    UNICODE_STRING SectionName;
    ACCESS_MASK DesiredAccess;
    LARGE_INTEGER LocalSize;
    PLARGE_INTEGER SectionSize = NULL;
    ULONG Attributes;
 
    /* Set default access */
    DesiredAccess = STANDARD_RIGHTS_REQUIRED | SECTION_QUERY | SECTION_MAP_READ;
 
    /* Get the attributes for the actual allocation and cleanup flProtect */
    Attributes = flProtect & (SEC_FILE | SEC_IMAGE | SEC_RESERVE | SEC_NOCACHE | SEC_COMMIT | SEC_LARGE_PAGES);
    flProtect ^= Attributes;
 
    /* If the caller didn't say anything, assume SEC_COMMIT */
    if (!Attributes) Attributes = SEC_COMMIT;
 
    /* Now check if the caller wanted write access */
    if (flProtect == PAGE_READWRITE)
    {
        /* Give it */
        DesiredAccess |= SECTION_MAP_WRITE;
    }
    else if (flProtect == PAGE_EXECUTE_READWRITE)
    {
        /* Give it */
        DesiredAccess |= (SECTION_MAP_WRITE | SECTION_MAP_EXECUTE);
    }
    else if (flProtect == PAGE_EXECUTE_READ)
    {
        /* Give it */
        DesiredAccess |= SECTION_MAP_EXECUTE;
    }
    else if ((flProtect == PAGE_EXECUTE_WRITECOPY) &&
             (NtCurrentPeb()->OSMajorVersion >= 6))
    {
        /* Give it */
        DesiredAccess |= (SECTION_MAP_WRITE | SECTION_MAP_EXECUTE);
    }
    else if ((flProtect != PAGE_READONLY) && (flProtect != PAGE_WRITECOPY))
    {
        SetLastError(ERROR_INVALID_PARAMETER);
        return NULL;
    }
 
    /* Now check if we got a name */
    if (lpName) RtlInitUnicodeString(&SectionName, lpName);
 
    /* Now convert the object attributes */
    ObjectAttributes = BaseFormatObjectAttributes(&LocalAttributes,
                                                    lpFileMappingAttributes,
                                                    lpName ? &SectionName : NULL);
 
    /* Check if we got a size */
    if (dwMaximumSizeLow || dwMaximumSizeHigh)
    {
        /* Use a LARGE_INTEGER and convert */
        SectionSize = &LocalSize;
        SectionSize->LowPart = dwMaximumSizeLow;
        SectionSize->HighPart = dwMaximumSizeHigh;
    }
 
    /* Make sure the handle is valid */
    if (hFile == INVALID_HANDLE_VALUE)
    {
        /* It's not, we'll only go on if we have a size */
        hFile = NULL;
        if (!SectionSize)
        {
            /* No size, so this isn't a valid non-mapped section */
            SetLastError(ERROR_INVALID_PARAMETER);
            return NULL;
        }
    }
 
    /* Now create the actual section */
    Status = NtCreateSection(&SectionHandle,
                             DesiredAccess,
                             ObjectAttributes,
                             SectionSize,
                             flProtect,
                             Attributes,
                             hFile);
    if (!NT_SUCCESS(Status))
    {
        /* We failed */
        BaseSetLastNTError(Status);
        return NULL;
    }
    else if (Status == STATUS_OBJECT_NAME_EXISTS)
    {
        SetLastError(ERROR_ALREADY_EXISTS);
    }
    else
    {
        SetLastError(ERROR_SUCCESS);
    }
 
    /* Return the section */
    return SectionHandle;
}

FlushViewOfFile()

BOOL NTAPI FlushViewOfFile	(	IN LPCVOID	lpBaseAddress,
		IN SIZE_T	dwNumberOfBytesToFlush
	)

Definition at line 352 of file filemap.c.

{
    NTSTATUS Status;
    PVOID BaseAddress = (PVOID)lpBaseAddress;
    SIZE_T NumberOfBytesToFlush = dwNumberOfBytesToFlush;
    IO_STATUS_BLOCK IoStatusBlock;
 
    /* Flush the view */
    Status = NtFlushVirtualMemory(NtCurrentProcess(),
                                  &BaseAddress,
                                  &NumberOfBytesToFlush,
                                  &IoStatusBlock);
    if (!NT_SUCCESS(Status) && (Status != STATUS_NOT_MAPPED_DATA))
    {
        /* We failed */
        BaseSetLastNTError(Status);
        return FALSE;
    }
 
    /* Return success */
    return TRUE;
}

Referenced by DPLAYX_ConstructData().

MapViewOfFile()

LPVOID NTAPI MapViewOfFile	(	HANDLE	hFileMappingObject,
		DWORD	dwDesiredAccess,
		DWORD	dwFileOffsetHigh,
		DWORD	dwFileOffsetLow,
		SIZE_T	dwNumberOfBytesToMap
	)

Definition at line 230 of file filemap.c.

{
    /* Call the extended API */
    return MapViewOfFileEx(hFileMappingObject,
                           dwDesiredAccess,
                           dwFileOffsetHigh,
                           dwFileOffsetLow,
                           dwNumberOfBytesToMap,
                           NULL);
}

MapViewOfFileEx()

LPVOID NTAPI MapViewOfFileEx	(	HANDLE	hFileMappingObject,
		DWORD	dwDesiredAccess,
		DWORD	dwFileOffsetHigh,
		DWORD	dwFileOffsetLow,
		SIZE_T	dwNumberOfBytesToMap,
		LPVOID	lpBaseAddress
	)

Definition at line 162 of file filemap.c.

{
    NTSTATUS Status;
    LARGE_INTEGER SectionOffset;
    SIZE_T ViewSize;
    ULONG Protect;
    LPVOID ViewBase;
 
    /* Convert the offset */
    SectionOffset.LowPart = dwFileOffsetLow;
    SectionOffset.HighPart = dwFileOffsetHigh;
 
    /* Save the size and base */
    ViewBase = lpBaseAddress;
    ViewSize = dwNumberOfBytesToMap;
 
    /* Convert flags to NT Protection Attributes */
    if (dwDesiredAccess == FILE_MAP_COPY)
    {
        Protect = PAGE_WRITECOPY;
    }
    else if (dwDesiredAccess & FILE_MAP_WRITE)
    {
        Protect = (dwDesiredAccess & FILE_MAP_EXECUTE) ?
                   PAGE_EXECUTE_READWRITE : PAGE_READWRITE;
    }
    else if (dwDesiredAccess & FILE_MAP_READ)
    {
        Protect = (dwDesiredAccess & FILE_MAP_EXECUTE) ?
                   PAGE_EXECUTE_READ : PAGE_READONLY;
    }
    else
    {
        Protect = PAGE_NOACCESS;
    }
 
    /* Map the section */
    Status = NtMapViewOfSection(hFileMappingObject,
                                NtCurrentProcess(),
                                &ViewBase,
                                0,
                                0,
                                &SectionOffset,
                                &ViewSize,
                                ViewShare,
                                0,
                                Protect);
    if (!NT_SUCCESS(Status))
    {
        /* We failed */
        BaseSetLastNTError(Status);
        return NULL;
    }
 
    /* Return the base */
    return ViewBase;
}

Referenced by DPLAYX_ConstructData(), and MapViewOfFile().

OpenFileMappingA()

HANDLE NTAPI OpenFileMappingA	(	IN DWORD	dwDesiredAccess,
		IN BOOL	bInheritHandle,
		IN LPCSTR	lpName
	)

Definition at line 284 of file filemap.c.

{
    ConvertOpenWin32AnsiObjectApiToUnicodeApi(FileMapping, dwDesiredAccess, bInheritHandle, lpName);
}

Referenced by doChild(), test_CreateFileMapping(), test_filemap_security(), and test_MapViewOfFile().

OpenFileMappingW()

HANDLE NTAPI OpenFileMappingW	(	IN DWORD	dwDesiredAccess,
		IN BOOL	bInheritHandle,
		IN LPCWSTR	lpName
	)

Definition at line 297 of file filemap.c.

{
    NTSTATUS Status;
    HANDLE SectionHandle;
    OBJECT_ATTRIBUTES ObjectAttributes;
    UNICODE_STRING UnicodeName;
 
    /* We need a name */
    if (!lpName)
    {
        /* Otherwise, fail */
        SetLastError(ERROR_INVALID_PARAMETER);
        return NULL;
    }
 
    /* Convert attributes */
    RtlInitUnicodeString(&UnicodeName, lpName);
    InitializeObjectAttributes(&ObjectAttributes,
                               &UnicodeName,
                               (bInheritHandle ? OBJ_INHERIT : 0),
                               BaseGetNamedObjectDirectory(),
                               NULL);
 
    /* Convert COPY to READ */
    if (dwDesiredAccess == FILE_MAP_COPY)
    {
        /* Fixup copy */
        dwDesiredAccess = SECTION_MAP_READ;
    }
    else if (dwDesiredAccess & FILE_MAP_EXECUTE)
    {
        /* Fixup execute */
        dwDesiredAccess = (dwDesiredAccess & ~FILE_MAP_EXECUTE) | SECTION_MAP_EXECUTE;
    }
 
    /* Open the section */
    Status = NtOpenSection(&SectionHandle, dwDesiredAccess, &ObjectAttributes);
    if (!NT_SUCCESS(Status))
    {
        /* We failed */
        BaseSetLastNTError(Status);
        return NULL;
    }
 
    /* Otherwise, return the handle */
    return SectionHandle;
}

Referenced by cache_container_map_index(), ImmPutImeMenuItemsIntoMappedFile(), main(), map_memory(), and OutputDebugStringA().

UnmapViewOfFile()

BOOL NTAPI UnmapViewOfFile

(

LPCVOID

lpBaseAddress

)

Definition at line 250 of file filemap.c.

{
    NTSTATUS Status;
 
    /* Unmap the section */
    Status = NtUnmapViewOfSection(NtCurrentProcess(), (PVOID)lpBaseAddress);
    if (!NT_SUCCESS(Status))
    {
        /* Check if the pages were protected */
        if (Status == STATUS_INVALID_PAGE_PROTECTION)
        {
            /* Flush the region if it was a "secure memory cache" */
            if (RtlFlushSecureMemoryCache((PVOID)lpBaseAddress, 0))
            {
                /* Now try to unmap again */
                Status = NtUnmapViewOfSection(NtCurrentProcess(), (PVOID)lpBaseAddress);
                if (NT_SUCCESS(Status)) return TRUE;
            }
        }
 
        /* We failed */
        BaseSetLastNTError(Status);
        return FALSE;
    }
 
    /* Otherwise, return success */
    return TRUE;
}