> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ApuAlloc

> ApuAlloc

# ApuAlloc

APU 물리적 메모리를 할당합니다.

## Syntax

```cpp theme={null}
HRESULT ApuAlloc(  
         void** virtualAddress,  
         APU_ADDRESS* physicalAddress,  
         UINT32 sizeInBytes,  
         UINT32 alignmentInBytes = 4,  
         UINT32 flags = APU_ALLOC_CACHED  
)  
```

### Parameters

*virtualAddress*   \_Result\_nullonfailure\_ \_Outptr\_result\_bytebuffer\_(sizeInBytes)\
Type: void\*\*

반환되는 가상 주소입니다.

*physicalAddress*   \_Result\_zeroonfailure\_ \_Out\_opt\_\
Type: APU\_ADDRESS\*

반환되는 `APU_ADDRESS`이며 APU에서 사용됩니다.

*sizeInBytes*   \_In\_\
Type: UINT32

할당 크기(바이트 단위)입니다.

*alignmentInBytes*   \_In\_\
Type: UINT32

정렬(바이트 단위)입니다. 2의 거듭제곱이어야 하며 4 이상이어야 합니다.

*flags*\
Type: UINT32

할당 플래그: `APU_ALLOC_CACHED` 또는 `APU_ALLOC_NONCACHED`.

### Return value

Type: HRESULT

이 메서드는 다음 값을 반환할 수 있습니다:

| 반환 코드          | 설명                                                                                                                                                   |
| :------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------- |
| S\_OK          | 성공                                                                                                                                                   |
| E\_INVALIDARG  | 유효하지 않은 인수. 예: virtual address == nullptr, size == 0, alignment == 0, (alignment & 0x3) != 0, (alignment & (alignment - 1)) != 0, 또는 유효하지 않은 flags 값 |
| E\_OUTOFMEMORY | 메모리 할당 실패                                                                                                                                            |

## Remarks

반환되는 가상 주소와 물리적 주소는 동일한 주소 공간의 서로 다른 뷰를 나타냅니다. 하나를 해제하면 다른 하나도 무효화됩니다. 할당을 해제하려면 [ApuFree](/reference/audio/apu/functions/apufree)를 사용하세요.

## Requirements

**Header:** apu.h

**Library:** acphal.lib

**지원 플랫폼:** XBOX One 제품군 콘솔 및 XBOX Series 콘솔

## 개념 설명서

* [XMA2 개요](/build/console-features/audio/overviews/xma2-overview)

## See also

[ApuFree](/reference/audio/apu/functions/apufree)\
[APU](/reference/audio/apu/apu_members)


## Related topics

- [ApuFree](/ko/reference/audio/apu/functions/apufree.md)
- [ApuMapApuAddress](/ko/reference/audio/apu/functions/apumapapuaddress.md)
- [XMA2 개요](/ko/build/console-features/audio/overviews/xma2-overview.md)
- [ApuMapVirtualAddress](/ko/reference/audio/apu/functions/apumapvirtualaddress.md)
- [ApuIsVirtualAddressValid](/ko/reference/audio/apu/functions/apuisvirtualaddressvalid.md)