Compartilhar via


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

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). Deve ser implementado por drivers WDDM (Windows Display Driver Model) 1.3 e posteriores.

Sintaxe

PFND3DWDDM1_3DDI_SETMARKERMODE Pfnd3dwddm13DdiSetmarkermode;

void Pfnd3dwddm13DdiSetmarkermode(
  D3D10DDI_HDEVICE hDevice,
  D3DWDDM1_3DDI_MARKER_TYPE Type,
  UINT Flags
)
{...}

Parâmetros

hDevice

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

Type

Um valor da enumeração D3DWDDM1_3DDI_MARKER_TYPE 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 D3DWDDM1_3DDI_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 English-US 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.

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.

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

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

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows 8.1, WDDM 1.3 e posterior
servidor com suporte mínimo Windows Server 2012 R2
da Plataforma de Destino Área de trabalho
cabeçalho d3d10umddi.h (inclua D3d10umddi.h)

Consulte também

D3DWDDM1_3DDI_MARKER_TYPE