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 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

Nenhum

Comentários

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 de modo de usuário, indicado pelo tipo D3DWDDM1_3DDI_MARKER_TYPE_PROFILE :

• Use instrumentação leve que não produz uma correlação forte com 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 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

Confira também

D3DWDDM1_3DDI_MARKER_TYPE