Pular para o conteúdo principal

Método XGMemoryLayout::CreateMapping (família XBOX One)

Cria um novo mapeamento com o nome especificado.

Sintaxe

Parâmetros

strName   _In_z_
Tipo: WCHAR*
O nome do novo mapeamento. pMapping   _Out_
Tipo: XGMemoryLayoutMapping *
O novo mapeamento como um ponteiro para uma estrutura XGMemoryLayoutMapping. AlignmentBytes   _In_
Tipo: UINT32
O alinhamento do endereço virtual do mapeamento, em bytes. Especifique 0 para o alinhamento padrão de XG_GPU_PAGE_SIZE_BYTES.

Valor retornado

Tipo: HRESULT S_OK, E_INVALIDARG ou E_OUTOFMEMORY.

Comentários

Cria um novo mapeamento com o nome fornecido. Defina AlignmentBytes como 0 para usar o alinhamento padrão, XG_GPU_PAGE_SIZE_BYTES, para o alinhamento do endereço virtual do mapeamento. Essa constante representa o tamanho, em bytes, de uma página de GPU do XG. Esse tamanho normalmente é de 64 KB, o que pode ser verificado por meio do método XGMemoryLayout::GetPageSizeBytes. O novo mapeamento é criado como um ponteiro para uma estrutura XGMemoryLayoutMapping. Este método é semelhante ao método XGMemoryLayout::MapFromPattern, com a diferença de que MapFromPattern mapeia páginas usando um padrão predefinido passado como uma matriz de bytes.

Requisitos

Cabeçalho: xgmemory.h Plataformas compatíveis: família XBOX One

Confira também

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