Skip to main content

ApuCreateHeap

APU 힙을 생성합니다.

Syntax

Parameters

cachedSizeInBytes   _In_
Type: UINT32
캐시된 메모리 할당의 크기(바이트 단위)입니다. nonCachedSizeInBytes   _In_opt_
Type: UINT32
캐시되지 않은 할당의 크기(바이트 단위)입니다. 0이면 기본 할당인 약 1MB를 사용합니다.

Return value

Type: HRESULT 이 메서드는 다른 오류 코드 외에도 다음 값을 반환할 수 있습니다:

Remarks

APU 힙은 하나만 생성할 수 있으며, 프로세스의 수명 동안 유지됩니다. 힙은 프로세스가 종료될 때만 해제됩니다. 특정 요구사항에 맞게 힙이 할당되도록 하려면 다른 ACP HAL 및 APU 메서드보다 먼저 이 메서드를 호출하세요. 이 메서드보다 먼저 ACP HAL (AcpHal.h) 또는 APU 메서드가 호출되면 캐시된 64MB 힙과 캐시되지 않은 약 1MB 힙이 할당됩니다. 이후 이 메서드를 호출하면 APU_E_HEAP_ALREADY_ALLOCATED로 실패합니다. 캐시된 메모리는 모든 Waves 자산과 명령 및 메시지 큐에 사용됩니다. 캐시되지 않은 메모리는 SHAPE 컨텍스트와 알림에 사용됩니다.

Requirements

Header: apu.h Library: acphal.lib 지원 플랫폼: XBOX One 제품군 콘솔 및 XBOX Series 콘솔

개념 설명서

See also

APU
마지막 수정일 2026년 8월 24일