PFND3D11_1DDI_ASSIGNDEBUGBINARY Rückruffunktion (d3d10umddi.h)

Artikel
02/06/2025

Stellt die vollständige Shader-Binärdatei bereit, die nach der Shadererstellung verfügbar ist. Die vollständige Shader-Binärdatei ermöglicht es einem Treiber, Debuginformationen oder andere Shader-Binärinformationen abzurufen, die normalerweise nicht für den Treiber verfügbar wären.

Syntax

PFND3D11_1DDI_ASSIGNDEBUGBINARY Pfnd3d111DdiAssigndebugbinary;

void Pfnd3d111DdiAssigndebugbinary(
       D3D10DDI_HDEVICE unnamedParam1,
       D3D10DDI_HSHADER unnamedParam2,
       UINT uBinarySize,
  [in] const VOID *pBinary
)
{...}

Parameter

unnamedParam1

hDevice [in]

Ein Handle für das Anzeigegerät (Grafikkontext).

unnamedParam2

hShader- [in]

Ein Handle für die privaten Daten des Treibers für das Shaderobjekt.

uBinarySize

Die Größe der vollständigen Shader-Binärdatei in Byte.

[in] pBinary

Ein Zeiger auf die vollständige Shader-Binärdatei.

Rückgabewert

Nichts

Bemerkungen

Der Treiber kann die pfnSetErrorCb Rückruffunktion verwenden, um einen Fehlercode festzulegen.

AssignDebugBinary wird nur aufgerufen, wenn alle folgenden Bedingungen zutreffen:

Das Gerät kann gedebuggt werden.
Der Anzeigetreiber für den Benutzermodus hat den D3D11_1DDI_D3D11_OPTIONS_DATAfestgelegt.AssignDebugBinarySupport flag to TRUE.
Eine Shadererstellungsfunktion CreateXxxShaderXxx- aufgerufen wurde, ist erfolgreich und hat ein Handle an den Shader zurückgegeben.

Der Treiber sollte keinen Fehler haben, mit Ausnahme von D3DDDIERR_DEVICEREMOVED. Wenn der Treiber daher einen Fehler außer D3DDDIERR_DEVICEREMOVEDübergibt, bestimmt die Microsoft Direct3D-Laufzeit in einem Aufruf der pfnSetErrorCb--Funktion, dass der Fehler kritisch ist. Selbst wenn das Gerät entfernt wurde, ist der Treiber nicht erforderlich, um D3DDDIERR_DEVICEREMOVEDzurückzugeben; Wenn die Geräteentfernung jedoch den Vorgang von AssignDebugBinary beeinträchtigt (was normalerweise nicht geschehen sollte), kann der Treiber D3DDDIERR_DEVICEREMOVEDzurückgeben.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 8
mindestens unterstützte Server-	Windows Server 2012
Zielplattform-	Desktop
Header-	d3d10umddi.h (include D3d10umddi.h)

Siehe auch

D3D11_1DDI_D3D11_OPTIONS_DATA

pfnSetErrorCb

Freigeben über