Método ID3D12Debug5::SetEnableAutoName (d3d12sdklayers.h)

Configura la nomenclatura automática de objetos.

Sintaxis

void SetEnableAutoName(
  BOOL Enable
);

Parámetros

Enable

Tipo: BOOL

true para habilitar la nomenclatura automática; false para deshabilitar la nomenclatura automática.

Valor devuelto

None

Observaciones

De forma predeterminada, los objetos no se denominan a menos que use ID3D12Object::SetName o ID3D12Object::SetPrivateData para asignar un nombre.

Se recomienda asignar un nombre a todos los objetos de Direct3D 12; al menos en compilaciones de depuración. Si no lo hace, es posible que le resulte conveniente permitir la asignación automática de nombres para cubrir los huecos. A los objetos de Direct3D 12 creados con el nombre automático habilitado se les asigna automáticamente un nombre, que se usa para la salida de la capa de depuración y para los datos de error de la página DRED.

Por lo tanto, para no crear una dependencia en un formato de nomenclatura automática específico, no se pueden recuperar las cadenas de nombre automático mediante ID3D12Object::GetName o ID3D12Object::GetPrivateData. Sin embargo, para generar una cadena de nombre única, Direct3D 12 usa el identificador único local (LUID) asignado a cada objeto ID3D12DeviceChild en tiempo de creación. Puede recuperar ese LUID mediante ID3D12Object::GetPrivateData con el valor REFGUIDWKPDID_D3D12UniqueObjectId. Es posible que le resulte útil para sus propios esquemas de nomenclatura de objetos.

Al depurar software existente, puede controlar la nomenclatura automática mediante la utilidad de herramientas de gráficos D3DConfig y el comando d3dconfig.exe device auto-debug-name=forced-on.

Cualquier objeto con un nombre con ID3D12Object::SetName o ID3D12Object::SetPrivateData usa el nombre asignado en lugar del nombre automático.

Requisitos

Consulte también

• ID3D12Debug5