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

Artigo
02/06/2025

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 de 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 sombreador.

uBinarySize

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

[in] pBinary

Um ponteiro para o binário de sombreador completo.

Valor de retorno

Nenhum

Observações

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.sinalizador AssignDebugBinarySupport para verdadeiro.
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 por D3DDDIERR_DEVICEREMOVED. Portanto, se o driver passar algum 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 será necessário para 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
de cliente com suporte mínimo	Windows 8
servidor com suporte mínimo	Windows Server 2012
da Plataforma de Destino	Área de trabalho
cabeçalho	d3d10umddi.h (inclua D3d10umddi.h)

Consulte também

D3D11_1DDI_D3D11_OPTIONS_DATA

pfnSetErrorCb

Partilhar via