ZwAllocateVirtualMemory 함수(ntifs.h)

ZwAllocateVirtualMemory는 지정된 프로세스의 사용자 모드 가상 주소 공간 내에 있는 페이지 영역을 예약, 커밋 또는 둘 다.

통사론

NTSYSAPI NTSTATUS ZwAllocateVirtualMemory(
  [in]      HANDLE    ProcessHandle,
  [in, out] PVOID     *BaseAddress,
  [in]      ULONG_PTR ZeroBits,
  [in, out] PSIZE_T   RegionSize,
  [in]      ULONG     AllocationType,
  [in]      ULONG     Protect
);

매개 변수

[in] ProcessHandle

매핑을 수행해야 하는 프로세스에 대한 핸들입니다. Ntddk.h에 정의된 NtCurrentProcess 매크로를 사용하여 현재 프로세스를 지정합니다.

[in, out] BaseAddress

할당된 페이지 영역의 기본 주소를 받을 변수에 대한 포인터입니다. 이 매개 변수의 초기 값이NULL이 아닌경우 지정된 가상 주소에서 시작하여 다음 호스트 페이지 크기 주소 경계로 반올림되는 지역이 할당됩니다. 이 매개 변수의 초기 값이 NULL경우 운영 체제에서 지역을 할당할 위치를 결정합니다.

[in] ZeroBits

섹션 뷰의 기본 주소에서 0이어야 하는 상위 주소 비트 수입니다. 이 값은 21 미만이어야 하며 BaseAddress NULL때 운영 체제에서 지역을 할당할 위치를 결정하는 경우에만 사용됩니다.

[in, out] RegionSize

할당된 페이지 영역의 실제 크기(바이트)를 받는 변수에 대한 포인터입니다. 이 매개 변수의 초기 값은 영역의 크기(바이트)를 지정하고 다음 호스트 페이지 크기 경계로 반올림됩니다. * RegionSize 입력에서 0일 수 없습니다.

[in] AllocationType

수행할 할당 유형을 지정하는 플래그가 포함된 비트 마스크입니다. 다음 표에서는 이러한 플래그에 대해 설명합니다.

[in] Protect

커밋된 페이지 영역에 원하는 보호를 지정하는 페이지 보호 플래그가 포함된 비트 마스크입니다. 다음 표에서는 이러한 플래그에 대해 설명합니다.

반환 값

ZwAllocateVirtualMemory STATUS_SUCCESS 또는 오류 상태 코드를 반환합니다. 가능한 오류 상태 코드에는 다음이 포함됩니다.

발언

ZwAllocateVirtualMemory 다음 작업을 수행할 수 있습니다.

• ZwAllocateVirtualMemory이전 호출로 예약된 페이지 영역을 커밋합니다.

• 무료 페이지 영역을 예약합니다.

• 체험 페이지 영역을 예약하고 커밋합니다.

커널 모드 드라이버는 ZwAllocateVirtualMemory 사용하여 지정된 프로세스에서 애플리케이션에 액세스할 수 있는 가상 주소 범위를 예약한 다음, 예약된 범위에서 개별 페이지를 커밋하기 위해 ZwAllocateVirtualMemory 추가 호출할 수 있습니다. 이렇게 하면 프로세스가 필요할 때까지 실제 스토리지를 사용하지 않고도 해당 가상 주소 공간의 범위를 예약할 수 있습니다.

프로세스의 가상 주소 공간의 각 페이지는 다음 표에 설명된 세 가지 상태 중 하나에 있습니다.

ZwAllocateVirtualMemory 호출하여 할당된 메모리는 ZwFreeVirtualMemory호출하여 해제되어야 합니다.

메모리 관리에 대한 자세한 내용은 Windows 드라이버메모리 관리를 참조하세요.

커널 모드 드라이버의 호출의 경우 NtXxx 및 ZwXxx 버전의 Windows Native System Services 루틴은 입력 매개 변수를 처리하고 해석하는 방식으로 다르게 동작할 수 있습니다. NtXxx ZwXxx 루틴 버전 간의 관계에 대한 자세한 내용은 네이티브 시스템 서비스 루틴Nt 및 Zw 버전 사용 참조하세요.

요구 사항

참고 항목

네이티브 시스템 서비스 루틴 Nt 및 Zw 버전 사용

ZwFreeVirtualMemory