Pular para o conteúdo principal
Associa um nome ao objeto de dispositivo. Esse nome é usado em diagnósticos de depuração e ferramentas.

Sintaxe

Parâmetros

Name [in]
Tipo: LPCWSTR
Uma cadeia de caracteres UNICODE terminada em NULL que contém o nome a ser associado ao objeto de dispositivo.

Valor retornado

Tipo: HRESULT Este método retorna um dos Códigos de retorno do Direct3D 12.

Comentários

Este método aceita nomes UNICODE. Observe que este é simplesmente um wrapper de conveniência em torno de ID3D12Object::SetPrivateData com WKPDID_D3DDebugObjectNameW. Portanto, os nomes definidos com SetName podem ser recuperados com ID3D12Object::GetPrivateData com o mesmo GUID. Além disso, o D3D12 oferece suporte a cadeias de caracteres estreitas para nomes, usando diretamente o GUID WKPDID_D3DDebugObjectName.

Requisitos

Cabeçalho: d3d12_xs.h ou d3d12_x.h
Biblioteca: d3d12_xs.lib ou d3d12_x.lib
Plataformas compatíveis: consoles XBOX Series e família XBOX One

Confira também

Configuração do ambiente de programação do Direct3D 12 ID3D12Object
Última modificação em 6 de outubro de 2026