Pular para o conteúdo principal

ApuCreateHeap

Cria o heap da APU.

Sintaxe

Parâmetros

cachedSizeInBytes   _In_
Tipo: UINT32
Tamanho de uma alocação de memória em cache, em bytes. nonCachedSizeInBytes   _In_opt_
Tipo: UINT32
Tamanho de uma alocação sem cache, em bytes. Se for 0, será usada a alocação padrão de ~1 MB.

Valor de retorno

Tipo: HRESULT Além de outros códigos de erro, este método pode retornar os seguintes valores:

Comentários

Somente um único heap da APU pode ser criado; ele persiste durante todo o tempo de vida do processo. O heap é liberado somente quando o processo é encerrado. Para garantir que um heap seja alocado de acordo com seus requisitos específicos, chame este método antes de qualquer outro método do ACP HAL e da APU. Se qualquer método do ACP HAL (AcpHal.h) ou da APU for chamado antes deste método, serão alocados um heap em cache de 64 MB e um heap sem cache de ~1 MB; as chamadas subsequentes a este método falharão com APU_E_HEAP_ALREADY_ALLOCATED. A memória em cache é usada para todos os ativos do Waves e para as filas de comandos e mensagens. A memória sem cache é usada para contextos SHAPE e notificações.

Requisitos

Cabeçalho: apu.h Biblioteca: acphal.lib Plataformas compatíveis: consoles da família XBOX One e consoles XBOX Series

Documentação conceitual

Confira também

APU
Última modificação em 6 de outubro de 2026