Compartilhar via


PFND3D12DDI_BEGIN_PASS função de retorno de chamada (d3d12umddi.h)

O driver é notificado de que o aplicativo iniciou uma passagem de cargas de trabalho consistentes. Quando o driver é notificado de que uma passagem de aplicativo foi iniciada, o driver registra observações ou usa otimizações que foram descobertas.

Sintaxe

PFND3D12DDI_BEGIN_PASS Pfnd3d12ddiBeginPass;

void Pfnd3d12ddiBeginPass(
  D3D12DDI_HCOMMANDLIST unnamedParam1,
  D3D12DDI_HPASS unnamedParam2,
  D3D12DDI_PASS_FLAGS PassFlags
)
{...}

Parâmetros

unnamedParam1

Um identificador para os dados do driver para a lista de comandos. O driver usa essa região de memória para armazenar estruturas de dados internas relacionadas à sua lista de comandos.

unnamedParam2

Um identificador para a passagem que foi criada pelo aplicativo.

PassFlags

Um sinalizador para indicar o que o driver deve fazer quando um aplicativo inicia uma passagem.

Retornar valor

Nenhum

Comentários

Esse retorno de chamada é usado como parte de um teste para ver se os drivers podem encontrar ganhos de perf ao serem informados quando os aplicativos estão repetindo "passes" de cargas de trabalho consistentes. O aplicativo instrui o driver a observar como algumas passagens são executadas e dá ao driver a chance de fazer otimizações para execuções futuras da mesma passagem. O conteúdo de um "passe" pode ser qualquer coisa - cabe ao aplicativo ser relativamente consistente nas características gerais de desempenho de um passe.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 10
Versão mínima do UMDF D3D12DDI_SUPPORTED_0020
Cabeçalho d3d12umddi.h