XMemCreateWin32Heap
Win32 힙을 만듭니다.구문
매개 변수
HeapFlags _In_형식: ULONGLONG 만들 힙에 대한 메모리의 소스를 지정합니다.
baseAddress _In_
형식: PVOID 내부(in-place) 힙 할당의 기본 주소입니다.
HeapFlags가 XMEM_HEAP_INPLACE로 설정된 경우, 이 값은 4KB 경계에 정렬된 커밋된 메모리의 주소를 가리켜야 합니다. 그렇지 않으면 이 값은 NULL로 설정되어야 합니다.
반환 값
형식: HANDLE 성공하면 생성된 Win32 힙에 대한 핸들을 반환하고, 그렇지 않으면NULL을 반환합니다. 사용할 수 있는 경우 확장 오류 정보가 앱의 현재 XErrorCallback 콜백에 제공됩니다.
설명
이 함수는HeapFlags 및 baseAddress가 각각 나타내는 소스와 기본 주소에서 힙에 대한 메모리를 할당하여 Win32 힙을 만듭니다. 힙이 생성될 때 HeapFlags에 XMEM_HEAP_INPLACE가 지정되지 않은 경우 힙은 2MB 페이지(또는 XMEM_HEAP_64K_PAGES가 지정된 경우 64KB 페이지)로 지원됩니다. Win32 힙을 만들려고 시도하는 동안 오류가 발생하면 이 메서드는 NULL을 반환하고, 사용할 수 있는 경우 오류가 앱의 현재 XErrorCallback 콜백에 보고됩니다. 예외 오류 사례 처리에 대한 자세한 내용은 XError를 참조하세요.
메모리 구성 및 액세스에 대한 자세한 내용은 타이틀 및 개발 키트용 메모리 구성을 참조하세요.
도구 메모리 할당
HeapFlags에 XMEM_HEAP_TOOL이 지정된 경우, 함수는 프로파일링 모드 및 반복 모드 설정에 따라 도구 파티션에서 메모리를 할당하여 Win32 힙을 만들려고 시도합니다.
- 반복 모드가 비활성화되고 프로파일링 모드가 활성화된 경우 함수는 도구 파티션에서 요청된 양의 메모리를 할당하려고 시도합니다. 요청된 양을 사용할 수 없으면 오류가 발생합니다.
- 반복 모드가 비활성화되고 프로파일링 모드가 비활성화된 경우 오류가 발생합니다.
- 반복 모드가 활성화된 경우 함수는 타이틀 파티션에서 요청된 양의 메모리를 할당하려고 시도합니다. 요청된 양을 사용할 수 없으면 오류가 발생합니다.
요구 사항
헤더: xmem.h 라이브러리: xmem.lib 지원 플랫폼: XBOX One 제품군 콘솔 및 XBOX Series 콘솔함께 보기
메모리XMem