ApuAlloc

Allocates APU physical memory.

Syntax

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** Virtual address returned. physicalAddress   _Result_zeroonfailure_ _Out_opt_
Type: APU_ADDRESS* APU_ADDRESS returned; for use with the APU. sizeInBytes   _In_
Type: UINT32 Size of the allocation, in bytes. alignmentInBytes   _In_
Type: UINT32 Alignment, in bytes. Must be a power of 2 and greater than or equal to 4. flags
Type: UINT32 Allocation flag: APU_ALLOC_CACHED or APU_ALLOC_NONCACHED.

Return value

Type: HRESULT This method can return the following values:

Return code	Description
S_OK	Success
E_INVALIDARG	Invalid argument, such as virtual address == nullptr, size == 0, alignment == 0, (alignment & 0x3) != 0, (alignment & (alignment - 1)) != 0, or an invalid flags value
E_OUTOFMEMORY	Memory allocation failure

Remarks

The virtual and physical addresses that are returned represent different views of the same address space. Freeing one invalidates the other. To free an allocation, use ApuFree.

Requirements

Header: apu.h Library: acphal.lib Supported platforms: XBOX One family consoles and XBOX Series consoles

Conceptual documentation

XMA2 overview

(all) API references

Error codes

Audio API reference

Chat API reference

Developer kit only API reference

Graphics API reference

Input API reference

Lighting API reference

Networking API reference

XBOX PC remote iteration API reference

System API reference

Tools API reference

Windows device portal REST API reference

XBOX services API reference

MicrosoftGame.config reference

ApuAlloc

ApuAlloc

Syntax

Parameters

Return value

Remarks

Requirements

Conceptual documentation

See also

​ApuAlloc

​Syntax

​Parameters

​Return value

​Remarks

​Requirements

​Conceptual documentation

​See also

ApuAlloc

Syntax

Parameters

Return value

Remarks

Requirements

Conceptual documentation

See also