Compartilhar via

PFND3DDDI_SETMARKERMODE função de retorno de chamada (d3dumddi.h)

  • Artigo

Notifica o driver de exibição do modo de usuário de que ele deve dar suporte a um tipo de evento de marcador etw (Rastreamento de Eventos para Windows). Opcionalmente implementado por drivers WDDM (Windows Display Driver Model) 1.3 e posteriores em execução no hardware do Microsoft Direct3D Nível 9. (Confira os requisitos em Melhorias de desempenho de renderização do Direct3D.) Para hardware mais avançado, os drivers devem implementar a função SetMarkerMode .

Sintaxe

PFND3DDDI_SETMARKERMODE Pfnd3dddiSetmarkermode;

HRESULT Pfnd3dddiSetmarkermode(
  HANDLE hDevice,
  D3DDDI_MARKERTYPE Type,
  UINT Flags
)
{...}

Parâmetros

hDevice

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

Type

Um valor da enumeração D3DDDI_MARKERTYPE que indica o tipo de evento de marcador ao qual o driver deve dar suporte.

Flags

Um valor UINT que indica se o driver deve fornecer informações personalizadas em buffers de comando. Se definido como D3DDDI_SETMARKERMODE_CUSTOMDRIVEREVENTS, o driver deverá anotar e instrumentar buffers de comando com informações de evento personalizadas. Caso contrário, o driver não deve anotar buffers de comando.

A anotação pode estar na forma de uma cadeia de caracteres de texto na localidade inglês-EUA ou na forma de um valor de índice para um local em uma tabela de cadeia de caracteres. Para a última opção, o driver também deve implementar uma função que descreva as cadeias de caracteres que os valores de índice indicam.

Retornar valor

Retorna S_OK ou um resultado de erro apropriado se a função não for concluída com êxito.

Comentários

Siga estas diretrizes ao configurar eventos de marcador do tipo perfil em seu driver de modo de usuário, indicado pelo tipo de D3DDDIMT_PROFILE :

  1. Use instrumentação leve que não produz uma correlação forte com limites de comando gráficos.
  2. O driver deve ser capaz de amostrar o carimbo de data/hora da GPU no final do pipeline gráfico.
  3. Não use comandos de amostragem que coloquem uma carga de alto desempenho no pipeline gráfico, como comandos de espera por ociosidade. Para poder instrumentar eventos de marcador do tipo perfil, o driver não deve precisar liberar o pipeline ou os caches.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8.1, WDDM 1.3 e posterior
Servidor mínimo com suporte Windows Server 2012 R2
Plataforma de Destino Área de Trabalho
Cabeçalho d3dumddi.h (inclua D3d10umddi.h)

Confira também

D3DDDI_MARKERTYPE

SetMarkerMode