ApuAlloc

分配 APU 物理内存。

语法

HRESULT ApuAlloc(  
         void** virtualAddress,  
         APU_ADDRESS* physicalAddress,  
         UINT32 sizeInBytes,  
         UINT32 alignmentInBytes = 4,  
         UINT32 flags = APU_ALLOC_CACHED  
)  

参数

virtualAddress   _Result_nullonfailure_ _Outptr_result_bytebuffer_(sizeInBytes)
类型:void** 返回的虚拟地址。 physicalAddress   _Result_zeroonfailure_ _Out_opt_
类型:APU_ADDRESS* 返回的 APU_ADDRESS;供 APU 使用。 sizeInBytes   _In_
类型:UINT32 分配的大小,以字节为单位。 alignmentInBytes   _In_
类型:UINT32 对齐值,以字节为单位。必须是 2 的幂且大于或等于 4。 flags
类型:UINT32 分配标志:APU_ALLOC_CACHED 或 APU_ALLOC_NONCACHED。

返回值

类型:HRESULT 此方法可以返回以下值:

返回代码	描述
S_OK	成功
E_INVALIDARG	无效参数,例如 virtual address == nullptr、size == 0、alignment == 0、(alignment & 0x3) != 0、(alignment & (alignment - 1)) != 0 或无效的 flags 值
E_OUTOFMEMORY	内存分配失败

备注

返回的虚拟地址和物理地址表示同一地址空间的不同视图。释放其中一个会使另一个失效。若要释放已分配的内存,请使用 ApuFree。

要求

头文件: apu.h 库: acphal.lib 支持的平台: XBOX One 系列主机和 XBOX Series 主机

概念文档

XMA2 概述

另请参阅

ApuFree
APU

(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

语法

参数

返回值

备注

要求

概念文档

另请参阅

​ApuAlloc

​语法

​参数

​返回值

​备注

​要求

​概念文档

​另请参阅

ApuAlloc

语法

参数

返回值

备注

要求

概念文档

另请参阅