Share via

ID3D12Debug5::SetEnableAutoName-Methode (d3d12sdklayers.h)

  • Artikel

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

Weitere Informationen