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

Artigo
02/06/2025

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 pelo WDDM (Windows Display Driver Model) 1.3 e drivers posteriores em execução no hardware do Microsoft Direct3D Nível 9. (Consulte 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 UINT valor 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 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

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

Observações

Siga estas diretrizes ao configurar eventos de marcador do tipo perfil no driver do modo de usuário, indicado pelo tipo D3DDDIMT_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	d3dumddi.h (inclua D3d10umddi.h)

Consulte também

D3DDDI_MARKERTYPE

SetMarkerMode

Compartilhar via