CreateFileMapping2 함수(memoryapi.h)

지정된 파일에 대한 명명되거나 명명되지 않은 파일 매핑 개체를 만들거나 엽니다. 물리적 메모리에 대한 기본 NUMA 노드를 확장 매개 변수로 지정할 수 있습니다. ExtendedParameters 매개 변수를 참조하세요.

통사론

HANDLE CreateFileMapping2(
  HANDLE                 File,
  SECURITY_ATTRIBUTES    *SecurityAttributes,
  ULONG                  DesiredAccess,
  ULONG                  PageProtection,
  ULONG                  AllocationAttributes,
  ULONG64                MaximumSize,
  PCWSTR                 Name,
  MEM_EXTENDED_PARAMETER *ExtendedParameters,
  ULONG                  ParameterCount
);

매개 변수

File

형식: _In_ HANDLE

파일 매핑 개체를 만들 파일에 대한 핸들입니다.

flProtect 매개 변수가 지정하는 보호 플래그와 호환되는 액세스 권한으로 파일을 열어야 합니다. 필수는 아니지만 매핑하려는 파일을 단독 액세스를 위해 여는 것이 좋습니다. 자세한 내용은 파일 보안 및 액세스 권한참조하세요.

hFile INVALID_HANDLE_VALUE경우 호출 프로세스는 dwMaximumSizeHigh 파일 매핑 개체의 크기도 지정하고 dwMaximumSizeLow 매개 변수를 합니다. 이 시나리오에서 CreateFileMapping 파일 시스템의 파일 대신 시스템 페이징 파일에서 지원되는 지정된 크기의 파일 매핑 개체를 만듭니다.

SecurityAttributes

형식: _In_opt_ SECURITY_ATTRIBUTES*

반환된 핸들을 자식 프로세스에서 상속할 수 있는지 여부를 결정하는 SECURITY_ATTRIBUTES 구조체에 대한 포인터입니다. SECURITY_ATTRIBUTES 구조체의 lpSecurityDescriptor 멤버는 새 파일 매핑 개체에 대한 보안 설명자를 지정합니다.

lpAttributes NULL경우 핸들을 상속할 수 없으며 파일 매핑 개체는 기본 보안 설명자를 가져옵니다. 파일 매핑 개체에 대한 기본 보안 설명자의 ACL(액세스 제어 목록)은 작성자의 기본 또는 가장 토큰에서 가져옵니다. 자세한 내용은 파일 매핑 보안 및 액세스 권한참조하세요.

DesiredAccess

형식: _In_ ULONG

반환된 파일 매핑 핸들에 대한 원하는 액세스 마스크입니다. 액세스 권한 목록은 파일 매핑 보안 및 액세스 권한참조하세요.

PageProtection

형식: _In_ ULONG

파일 매핑 개체의 페이지 보호를 지정합니다. 개체의 모든 매핑된 뷰는 이 보호와 호환되어야 합니다.

이 매개 변수는 다음 값 중 하나일 수 있습니다.

AllocationAttributes

형식: _In_ ULONG

파일 매핑 개체에 대해 다음 특성 중 하나 이상을 지정할 수 있습니다. 또한 PageProtection 매개 변수를 참조하세요.

MaximumSize

형식: _In_ ULONG64

파일 매핑 개체의 최대 크기입니다.

이 매개 변수가 0인 경우 파일 매핑 개체의 최대 크기는 hFile 식별할 파일의 현재 크기와 같습니다.

길이가 0인 파일을 매핑하려고 시도하면 오류 코드가 ERROR_FILE_INVALID. 길이가 0인 파일을 테스트하고 해당 파일을 거부해야 합니다.

Name

형식: PCWSTR _In_opt_

파일 매핑 개체의 이름입니다.

이 매개 변수가 기존 매핑 개체의 이름과 일치하는 경우 함수는 flProtect 지정하는 보호를 사용하여 개체에 대한 액세스를 요청합니다.

이 매개 변수가 NULL경우 파일 매핑 개체는 이름 없이 만들어집니다.

lpName 기존 이벤트, 세마포, 뮤텍스, 대기 가능한 타이머 또는 작업 개체의 이름과 일치하면 함수가 실패하고 GetLastError 함수는 ERROR_INVALID_HANDLE반환합니다. 이러한 개체는 동일한 네임스페이스를 공유하기 때문에 발생합니다.

이름에는 전역 또는 세션 네임스페이스에서 개체를 명시적으로 만드는 "전역" 또는 "로컬" 접두사를 가질 수 있습니다. 이름의 나머지 부분에는 백슬래시 문자(\)를 제외한 모든 문자가 포함될 수 있습니다. 세션 0 이외의 세션에서 전역 네임스페이스에 파일 매핑 개체를 만들려면 SeCreateGlobalPrivilege 권한이 필요합니다. 자세한 내용은 커널 개체 네임스페이스참조하세요.

빠른 사용자 전환은 터미널 서비스 세션을 사용하여 구현됩니다. 로그온하는 첫 번째 사용자는 세션 0(0)을 사용하고, 로그온할 다음 사용자는 세션 1(1) 등을 사용합니다. 커널 개체 이름은 애플리케이션이 여러 사용자를 지원할 수 있도록 터미널 서비스에 대해 설명된 지침을 따라야 합니다.

ExtendedParameters

형식: _Inout_updates_opt_(ParameterCount) MEM_EXTENDED_PARAMETER*

MEM_EXTENDED_PARAMETER형식의 하나 이상의 확장 매개 변수에 대한 선택적 포인터입니다. 이러한 각 확장 매개 변수 값 자체에는 MemExtendedParameterAddressRequirements 또는 MemExtendedParameterNumaNode형식 필드가 있을 수 있습니다. 확장 매개 변수를 MemExtendedParameterNumaNode가 제공되지 않는 경우 동작은 VirtualAllocMapViewOfFile 함수와 동일합니다(즉, 실제 페이지의 기본 NUMA 노드는 먼저 메모리에 액세스하는 스레드의 이상적인 프로세서에 따라 결정됨).

ParameterCount

ULONG ParameterCount의

extendedParameters가리키는 확장 매개 변수 수입니다.

반환 값

함수가 성공하면 반환 값은 새로 만든 파일 매핑 개체에 대한 핸들입니다.

함수 호출 전에 개체가 있는 경우 함수는 지정된 크기가 아닌 현재 크기로 기존 개체에 대한 핸들을 반환하고 GetLastErrorERROR_ALREADY_EXISTS반환합니다.

함수가 실패하면 반환 값은 NULL. 확장 오류 정보를 얻으려면 GetLastError호출합니다.

발언

CreateFileMapping대한 설명 참조하세요.

예제

예를 들어 명명된 공유 메모리만들기 또는 큰 페이지사용하여 파일 매핑 만들기를 참조하세요.

요구 사항

참고 항목

closeHandle

CreateFileMappingNuma

파일 매핑 개체 만들기

DuplicateHandle

mapViewOfFile

mapViewOfFileEx

메모리 관리 함수

OpenFileMapping

ReadFile

SECURITY_ATTRIBUTES

UnmapViewOfFile

VirtualAlloc

WriteFile