Compartilhar via


PFND3D11_1DDI_ASSIGNDEBUGBINARY função de retorno de chamada (d3d10umddi.h)

Fornece o binário de sombreador completo que está disponível após a criação do sombreador. O binário de sombreador completo permite que um driver recupere informações de depuração ou outras informações binárias do sombreador que normalmente não estariam disponíveis para o driver.

Sintaxe

PFND3D11_1DDI_ASSIGNDEBUGBINARY Pfnd3d111DdiAssigndebugbinary;

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

Parâmetros

unnamedParam1

hDevice [in]

Um identificador para o dispositivo de exibição (contexto gráfico).

unnamedParam2

hShader [in]

Um identificador para os dados privados do driver para o objeto de sombreador.

uBinarySize

O tamanho, em bytes, do binário de sombreador completo.

[in] pBinary

Um ponteiro para o binário de sombreador completo.

Retornar valor

Nenhum

Comentários

O driver pode usar a função de retorno de chamada pfnSetErrorCb para definir um código de erro.

AssignDebugBinary será chamado somente se todos os seguintes forem verdadeiros:

  • O dispositivo pode ser depurado.
  • O driver de exibição do modo de usuário definiu o D3D11_1DDI_D3D11_OPTIONS_DATA. Atribua o sinalizadorDebugBinarySupport a TRUE.
  • Uma função de criação de sombreador CreateXxxShaderXxx foi chamada, foi bem-sucedida e retornou um identificador para o sombreador.
O driver não deve encontrar nenhum erro, exceto para D3DDDIERR_DEVICEREMOVED. Portanto, se o driver passar qualquer erro, exceto por D3DDDIERR_DEVICEREMOVED, em uma chamada para a função pfnSetErrorCb , o runtime do Microsoft Direct3D determinará que o erro é crítico. Mesmo que o dispositivo tenha sido removido, o driver não precisará retornar D3DDDIERR_DEVICEREMOVED; no entanto, se a remoção do dispositivo interferiu na operação de AssignDebugBinary (o que normalmente não deve acontecer), o driver poderá retornar D3DDDIERR_DEVICEREMOVED.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8
Servidor mínimo com suporte Windows Server 2012
Plataforma de Destino Área de Trabalho
Cabeçalho d3d10umddi.h (inclua D3d10umddi.h)

Confira também

D3D11_1DDI_D3D11_OPTIONS_DATA

pfnSetErrorCb