PFND3D11_1DDI_ASSIGNDEBUGBINARY funzione di callback (d3d10umddi.h)

Articolo
02/06/2025

Fornisce il file binario dello shader completo disponibile dopo la creazione dello shader. Il file binario full shader consente a un driver di recuperare informazioni di debug o altre informazioni binarie dello shader che normalmente non sarebbero disponibili per il driver.

Sintassi

PFND3D11_1DDI_ASSIGNDEBUGBINARY Pfnd3d111DdiAssigndebugbinary;

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

Parametri

unnamedParam1

hDevice [in]

Handle per il dispositivo di visualizzazione (contesto grafico).

unnamedParam2

hShader [in]

Handle per i dati privati del driver per l'oggetto shader.

uBinarySize

Dimensione, in byte, del file binario dello shader completo.

[in] pBinary

Puntatore al file binario dello shader completo.

Valore restituito

Nessuno

Osservazioni

Il driver può usare il pfnSetErrorCb funzione di callback per impostare un codice di errore.

AssignDebugBinary viene chiamato solo se sono soddisfatte tutte le condizioni seguenti:

È possibile eseguire il debug del dispositivo.
Il driver di visualizzazione in modalità utente ha impostato il D3D11_1DDI_D3D11_OPTIONS_DATA.flag AssignDebugBinarySupport per TRUE.
È stata chiamata una funzione di creazione dello shader CreateXxxShaderXxx è stata completata ed è stato restituito un handle allo shader.

Il driver non deve riscontrare alcun errore, ad eccezione di D3DDDIERR_DEVICEREMOVED. Pertanto, se il driver passa qualsiasi errore, ad eccezione di D3DDDIERR_DEVICEREMOVED, in una chiamata alla funzione pfnSetErrorCb, il runtime Di Microsoft Direct3D determinerà che l'errore è critico. Anche se il dispositivo è stato rimosso, il driver non è necessario per restituire D3DDDIERR_DEVICEREMOVED; Tuttavia, se la rimozione del dispositivo interferisce con l'operazione di AssignDebugBinary (che in genere non dovrebbe verificarsi), il driver può restituire D3DDDIERR_DEVICEREMOVED.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 8
server minimo supportato	Windows Server 2012
piattaforma di destinazione	Desktop
intestazione	d3d10umddi.h (include D3d10umddi.h)

Vedere anche

D3D11_1DDI_D3D11_OPTIONS_DATA

pfnSetErrorCb

Condividi tramite