Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Konfiguriert die automatische Benennung von Objekten.
Syntax
void SetEnableAutoName(
BOOL Enable
);
Parameter
Enable
Typ: BOOL
true , um die automatische Benennung zu aktivieren; false , um die automatische Benennung zu deaktivieren.
Rückgabewert
Keine
Bemerkungen
Standardmäßig werden Objekte nur benannt, wenn Sie ID3D12Object::SetName oder ID3D12Object::SetPrivateData verwenden, um einen Namen zuzuweisen.
Es empfiehlt sich, alle Direct3D 12-Objekte zu benennen. zumindest in Debugbuilds. Andernfalls empfiehlt es sich, die automatische Namenszuweisung zuzulassen, um die Lücken zu schließen. Direct3D 12-Objekte, die mit aktiviertem automatischen Namen erstellt wurden, erhalten automatisch einen Namen, der für die Ausgabe der Debugebene und für DRED-Seitenfehlerdaten verwendet wird.
Um keine Abhängigkeit von einem bestimmten Format für die automatische Benennung zu erstellen, können Sie die Autonamenzeichenfolgen nicht mithilfe von ID3D12Object::GetName oder ID3D12Object::GetPrivateData abrufen. Um jedoch eine eindeutige Namenszeichenfolge zu generieren, verwendet Direct3D 12 den lokal eindeutigen Bezeichner (LUID), der jedem ID3D12DeviceChild-Objekt zur Erstellung zugewiesen ist. Sie können diese LUID mithilfe von ID3D12Object::GetPrivateData mit dem REFGUID-WertWKPDID_D3D12UniqueObjectId abrufen. Möglicherweise finden Sie dies für Ihre eigenen Objektbenennungsschemas nützlich.
Beim Debuggen vorhandener Software können Sie die automatische Benennung mithilfe des Grafiktools-Hilfsprogramms D3DConfig und des Befehls d3dconfig.exe device auto-debug-name=forced-onsteuern.
Jedes Objekt, das mithilfe von ID3D12Object::SetName oder ID3D12Object::SetPrivateData einen Namen erhält, verwendet den zugewiesenen Namen anstelle des automatischen Namens.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 10 Build 20348 |
| Unterstützte Mindestversion (Server) | Windows 10 Build 20348 |
| Zielplattform | Windows |
| Kopfzeile | d3d12sdklayers.h |