Метод ID3D12Debug5::SetEnableAutoName (d3d12sdklayers.h)
Настраивает автоматическое именование объектов.
Синтаксис
void SetEnableAutoName(
BOOL Enable
);
Параметры
Enable
Тип: BOOL
true , чтобы включить автоматическое именование; false значение , чтобы отключить автоматическое именование.
Возвращаемое значение
None
Remarks
По умолчанию объекты не именуются, если для назначения имени не используется ID3D12Object::SetName или ID3D12Object::SetPrivateData .
Рекомендуется присвоить имена всем объектам Direct3D 12; по крайней мере в отладочных сборках. Если это не так, может оказаться удобным разрешить автоматическое назначение имен, чтобы устранить пробелы. Объектам Direct3D 12, созданным с включенным автоматическим именем, автоматически присваивается имя, которое используется для вывода отладочного слоя и для данных об ошибке страницы DRED.
Чтобы не создавать зависимость от определенного формата автоматического именования, нельзя получить строки автоименования с помощью ID3D12Object::GetName или ID3D12Object::GetPrivateData. Но для создания строки уникального имени Direct3D 12 использует локальный уникальный идентификатор (LUID), назначенный каждому объекту ID3D12DeviceChild во время создания. Этот LUID можно получить с помощью ID3D12Object::GetPrivateData со значением REFGUIDWKPDID_D3D12UniqueObjectId. Это может оказаться полезным для собственных схем именования объектов.
При отладке существующего программного обеспечения можно управлять автоматическим именованием с помощью служебной программы графических средств D3DConfig и команды d3dconfig.exe device auto-debug-name=forced-on.
Любой объект, которому присвоено имя с помощью ID3D12Object::SetName или ID3D12Object::SetPrivateData , использует назначенное имя вместо автоматического имени.
Требования
| Минимальная версия клиента | Windows 10 сборки 20348 |
| Минимальная версия сервера | Windows 10 сборки 20348 |
| Целевая платформа | Windows |
| Header | d3d12sdklayers.h |