VirtualAlloc2FromApp 함수(memoryapi.h)
호출 프로세스의 가상 주소 공간에서 페이지 영역의 상태를 예약, 커밋 또는 변경합니다. 이 함수에 의해 할당된 메모리는 자동으로 0으로 초기화됩니다.
이 함수를 사용하면 다음을 수행할 수 있습니다. 새 할당의 경우 가상 주소 공간의 범위와 2의 강력한 맞춤 제한을 지정할 수 있습니다. 임의의 수의 확장 매개 변수를 지정합니다. 물리적 메모리에 대한 기본 NUMA 노드를 확장 매개 변수로 지정합니다. 및 는 자리 표시자 작업(특히 대체)을 지정합니다.
NUMA 노드를 지정하려면 ExtendedParameters 매개 변수를 참조하세요.
구문
PVOID VirtualAlloc2FromApp(
[in, optional] HANDLE Process,
[in, optional] PVOID BaseAddress,
[in] SIZE_T Size,
[in] ULONG AllocationType,
[in] ULONG PageProtection,
[in, out, optional] MEM_EXTENDED_PARAMETER *ExtendedParameters,
[in] ULONG ParameterCount
);
매개 변수
[in, optional] Process
프로세스에 대한 핸들입니다. 함수는 이 프로세스의 가상 주소 공간 내에서 메모리를 할당합니다.
핸들에 PROCESS_VM_OPERATION 액세스 권한이 있어야 합니다. 자세한 내용은 프로세스 보안 및 액세스 권한을 참조하세요.
[in, optional] BaseAddress
할당하려는 페이지 영역에 대해 원하는 시작 주소를 지정하는 포인터입니다.
BaseAddress가 NULL인 경우 함수는 지역을 할당할 위치를 결정합니다.
BaseAddress가 NULL이 아닌 경우 제공된 MEM_ADDRESS_REQUIREMENTS 구조체는 모두 0으로 구성되어야 하며 기본 주소는 시스템 할당 세분성의 배수여야 합니다. 할당 세분성을 확인하려면 GetSystemInfo 함수를 사용합니다.
[in] Size
할당할 메모리 영역의 크기(바이트)입니다.
크기는 항상 페이지 크기의 배수여야 합니다.
BaseAddress가 NULL이 아닌 경우 함수는 BaseAddress에서 BaseAddress+ 크기까지 범위에서 하나 이상의 바이트를 포함하는 모든 페이지를 할당합니다. 예를 들어 페이지 경계를 가로지르는 2 바이트 범위는 함수가 두 페이지를 모두 할당하도록 합니다.
[in] AllocationType
메모리 할당 유형입니다. 이 매개 변수는 다음 값 중 하나를 포함해야 합니다.
| 값 | 의미 |
|---|---|
|
지정된 예약된 메모리 페이지에 대한 메모리 요금(전체 메모리 크기 및 디스크의 페이징 파일)을 할당합니다. 또한 함수는 호출자가 나중에 처음에 메모리에 액세스할 때 콘텐츠가 0이 되도록 보장합니다. 실제 실제 페이지는 가상 주소에 실제로 액세스하지 않는 한 할당되지 않습니다.
한 단계에서 페이지를 예약하고 커밋하려면 를 사용하여 Virtual2AllocFromApp 을 MEM_RESERVE 없이 MEM_COMMIT 지정하여 특정 주소 범위를 커밋하려고 시도하면 전체 범위 가 이미 예약되지 않은 한 NULL이 아닌 BaseAddress가 실패합니다. 결과 오류 코드가 ERROR_INVALID_ADDRESS. 이미 커밋된 페이지를 커밋하려고 하면 함수가 실패하지 않습니다. 즉, 각 페이지의 현재 약정 상태를 먼저 결정하지 않고도 페이지를 커밋할 수 있습니다. |
|
메모리 또는 디스크의 페이징 파일에 실제 실제 스토리지를 할당하지 않고 프로세스의 가상 주소 공간 범위를 예약합니다.
Virtual2AllocFromApp 함수에 대한 후속 호출에서 예약된 페이지를 커밋할 수 있습니다. 한 단계에서 페이지를 예약하고 커밋하려면 MEM_COMMIT MEM_RESERVE | 사용하여 Virtual2AllocFromApp을 호출합니다. malloc 및 LocalAlloc과 같은 다른 메모리 할당 함수는 릴리스될 때까지 예약된 메모리 범위를 사용할 수 없습니다. |
|
자리 표시자를 일반 프라이빗 할당으로 바꿉니다. 데이터/pf 지원 섹션 보기만 지원됩니다(이미지, 실제 메모리 등은 지원되지 않음). 자리 표시자를 바꿀 때 BaseAddress 및 Size 는 자리 표시자의 개체 틀과 정확히 일치해야 하며 제공된 모든 MEM_ADDRESS_REQUIREMENTS 구조체는 모두 0으로 구성되어야 합니다.
자리 표시자를 프라이빗 할당으로 바꾼 후 해당 할당을 자리 표시자로 다시 해제하려면 VirtualFree 및 VirtualFreeEx의 dwFreeType 매개 변수를 참조하세요. 자리 표시자는 예약된 메모리 영역의 유형입니다. |
|
자리 표시자를 만들려면 를 사용하여 VirtualAlloc2 를 MEM_RESERVE | MEM_RESERVE_PLACEHOLDER 호출하고 PageProtection을PAGE_NOACCESS. 자리 표시자를 해제/분할/병합하려면 VirtualFree 및 VirtualFreeEx의 dwFreeType 매개 변수를 참조하세요.
자리 표시자는 예약된 메모리 영역의 유형입니다. |
|
BaseAddress 및 Size로 지정된 메모리 범위의 데이터가 더 이상 관심이 없음을 나타냅니다. 페이지를 페이징 파일에서 읽거나 쓸 수 없습니다. 그러나 메모리 블록은 나중에 다시 사용되므로 커밋 해제하면 안 됩니다. 이 값은 다른 값과 함께 사용할 수 없습니다.
이 값을 사용하면 MEM_RESET 함께 작동하는 범위에 0이 포함되지 않습니다. 범위에 0이 포함되도록 하려면 메모리 커밋을 해제한 다음 다시 커밋합니다. MEM_RESET 지정하면 Virtual2AllocFromApp 함수는 보호 값을 무시합니다. 그러나 여전히 보호를PAGE_NOACCESS 같은 유효한 보호 값으로 설정해야 합니다. virtual2AllocFromApp 은 MEM_RESET 사용하고 메모리 범위가 파일에 매핑되는 경우 오류를 반환합니다. 공유 보기는 페이징 파일에 매핑된 경우에만 허용됩니다. |
|
MEM_RESET_UNDO MEM_RESET 이전에 성공적으로 적용된 주소 범위에서만 호출해야 합니다. BaseAddress 및 Size로 지정된 지정된 메모리 범위의 데이터가 호출자에게 관심이 있음을 나타내며 MEM_RESET 효과를 되돌리려고 시도합니다. 함수가 성공하면 지정된 주소 범위의 모든 데이터가 그대로 유지됩니다. 함수가 실패하면 주소 범위의 데이터 중 적어도 일부가 0으로 대체됩니다.
이 값은 다른 값과 함께 사용할 수 없습니다. 이전에 MEM_RESET 않은 주소 범위에서 MEM_RESET_UNDO 호출되면 동작이 정의되지 않습니다. MEM_RESET 지정하면 Virtual2AllocFromApp 함수는 보호 값을 무시합니다. 그러나 여전히 보호를PAGE_NOACCESS 같은 유효한 보호 값으로 설정해야 합니다. |
이 매개 변수는 표시된 대로 다음 값을 지정할 수도 있습니다.
| 값 | 의미 |
|---|---|
|
큰 페이지 지원을 사용하여 메모리를 할당합니다.
크기 및 맞춤은 큰 페이지 최소값의 배수여야 합니다. 이 값을 가져오려면 GetLargePageMinimum 함수를 사용합니다. 이 값을 지정하는 경우 MEM_RESERVE 및 MEM_COMMIT 지정해야 합니다. |
|
AWE( 주소 창 확장 ) 페이지를 매핑하는 데 사용할 수 있는 주소 범위를 예약합니다.
이 값은 다른 값이 아닌 MEM_RESERVE 사용해야 합니다. |
|
가능한 가장 높은 주소로 메모리를 할당합니다. 이는 특히 할당이 많은 경우 일반 할당보다 느려질 수 있습니다. |
|
시스템이 할당된 지역에 기록된 페이지를 추적하도록 합니다. 이 값을 지정하는 경우 MEM_RESERVE 지정해야 합니다.
지역이 할당되었거나 쓰기 추적 상태가 재설정된 이후 기록된 페이지의 주소를 검색하려면 GetWriteWatch 함수를 호출합니다. 쓰기 추적 상태를 다시 설정하려면 GetWriteWatch 또는 ResetWriteWatch를 호출합니다. 쓰기 추적 기능은 영역이 해제될 때까지 메모리 영역에 대해 사용하도록 설정된 상태로 유지됩니다. |
[in] PageProtection
할당할 페이지 영역에 대한 메모리 보호입니다. 페이지가 커밋되는 경우 메모리 보호 상수 중 하나를 지정할 수 있습니다. 다음 상수는 오류를 생성합니다.
- PAGE_EXECUTE
- PAGE_EXECUTE_READ
- PAGE_EXECUTE_READWRITE
- PAGE_EXECUTE_WRITECOPY
[in, out, optional] ExtendedParameters
MEM_EXTENDED_PARAMETER 형식의 확장 매개 변수 하나 이상에 대한 선택적 포인터입니다. 이러한 각 확장 매개 변수 값 자체에는 MemExtendedParameterAddressRequirements 또는 MemExtendedParameterNumaNode의 형식 필드가 있을 수 있습니다. MemExtendedParameterNumaNode 확장 매개 변수가 제공되지 않으면 동작은 VirtualAlloc/MapViewOfFile 함수와 동일합니다(즉, 실제 페이지에 대한 기본 NUMA 노드는 먼저 메모리에 액세스하는 스레드의 이상적인 프로세서에 따라 결정됨).
[in] ParameterCount
ExtendedParameters가 가리키는 확장 매개 변수 수입니다.
반환 값
함수가 성공하면 반환 값은 할당된 페이지 영역의 기본 주소입니다.
함수가 실패하면 반환 값은 NULL입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.
설명
이 API는 가상 주소 공간 관리에 대한 특정 요구 사항이 있는 고성능 게임 및 서버 애플리케이션을 지원하는 데 도움이 됩니다. 예를 들어 이전에 예약된 지역 위에 메모리를 매핑합니다. 이는 자동으로 래핑 링 버퍼를 구현하는 데 유용합니다. 그리고 특정 맞춤으로 메모리를 할당; 예를 들어 애플리케이션이 요청 시 큰/거대한 페이지 매핑 지역을 커밋할 수 있도록 합니다.
JIT(Just-In-Time) 기능을 사용하여 Windows 스토어 앱에서 Virtual2AllocFromApp 을 호출하여 JIT 기능을 사용할 수 있습니다. 앱은 JIT 기능을 사용하려면 앱 매니페스트 파일에 codeGeneration 기능을 포함해야 합니다.
각 페이지에는 연결된 페이지 상태가 있습니다. Virtual2AllocFromApp 함수는 다음 작업을 수행할 수 있습니다.
- 예약된 페이지의 영역 커밋
- 무료 페이지 영역 예약
- 무료 페이지 영역을 동시에 예약 및 커밋
Virtual2AllocFromApp을 사용하여 페이지 블록을 예약한 다음, Virtual2AllocFromApp을 추가로 호출하여 예약된 블록에서 개별 페이지를 커밋할 수 있습니다. 이렇게 하면 프로세스가 필요할 때까지 실제 스토리지를 사용하지 않고도 해당 가상 주소 공간의 범위를 예약할 수 있습니다.
BaseAddress 매개 변수가 NULL이 아닌 경우 함수는 BaseAddress 및 Size 매개 변수를 사용하여 할당할 페이지 영역을 계산합니다. 전체 페이지 범위의 현재 상태는 AllocationType 매개 변수에 지정된 할당 유형과 호환되어야 합니다. 그렇지 않으면 함수가 실패하고 페이지가 할당되지 않습니다. 이 호환성 요구 사항은 앞에서 설명한 대로 이미 커밋된 페이지를 커밋하는 것을 배제하지 않습니다.
Virtual2AllocFromApp 은 실행 파일 페이지를 만들 수 없습니다.
Virtual2AllocFromApp 함수를 사용하여 지정된 프로세스의 가상 주소 공간 내에서 AWE(Address Windowing Extensions) 메모리 영역을 예약할 수 있습니다. 그런 다음, 이 메모리 영역을 사용하여 애플리케이션에서 요구하는 대로 실제 페이지를 가상 메모리 내부 및 외부에 매핑할 수 있습니다. MEM_PHYSICAL 및 MEM_RESERVE 값은 AllocationType 매개 변수에 설정해야 합니다. MEM_COMMIT 값을 설정하면 안 됩니다. 페이지 보호는 PAGE_READWRITE 설정해야 합니다.
VirtualFree 함수는 커밋된 페이지를 커밋 해제하거나, 페이지의 스토리지를 해제하거나, 커밋된 페이지를 동시에 커밋 해제하고 해제할 수 있습니다. 예약된 페이지를 해제하여 무료 페이지로 만들 수도 있습니다.
실행 가능한 지역을 만들 때 호출 프로그램은 코드가 설정되면 FlushInstructionCache 에 대한 적절한 호출을 통해 캐시 일관성을 보장해야 합니다. 그렇지 않으면 새로 실행 가능한 지역에서 코드를 실행하려고 시도하면 예측할 수 없는 결과가 발생할 수 있습니다.
예제
코드 예제는 Virtual2Alloc을 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 10 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2016 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | memoryapi.h(Windows.h 포함) |
| 라이브러리 | WindowsApp.lib |
| DLL | Kernel32.dll |
참고 항목
피드백
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요. https://aka.ms/ContentUserFeedback
다음에 대한 사용자 의견 제출 및 보기