PFND3D11_1DDI_ASSIGNDEBUGBINARY funzione di callback (d3d10umddi.h)

  • Articolo

Fornisce il file binario shader completo disponibile dopo la creazione dello shader. Il file binario shader completo consente a un driver di recuperare informazioni di debug o altre informazioni binarie 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

Dimensioni, in byte, del file binario shader completo.

[in] pBinary

Puntatore al file binario shader completo.

Valore restituito

nessuno

Osservazioni

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

AssignDebugBinary viene chiamato solo se tutti i seguenti sono true:

  • Il dispositivo può essere sottoposto a debug.
  • Il driver di visualizzazione in modalità utente ha impostato il D3D11_1DDI_D3D11_OPTIONS_DATA. Flag AssignDebugBinarySupport su TRUE.
  • Una funzione di creazione shader CreateXxxShaderXxx è stata chiamata, ha avuto esito positivo e ha 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 determina che l'errore è critico. Anche se il dispositivo è stato rimosso, il driver non è necessario 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.

Requisiti

Requisito Valore
Client minimo supportato Windows 8
Server minimo supportato Windows Server 2012
Piattaforma di destinazione Desktop
Intestazione d3d10umddi.h (include D3d10umddi.h)

Vedi anche

D3D11_1DDI_D3D11_OPTIONS_DATA

pfnSetErrorCb