Compartir a través de

PFND3DDDI_SETMARKERMODE función de devolución de llamada (d3dumddi.h)

  • Artículo

Notifica al controlador de pantalla en modo de usuario que debe admitir un tipo de evento de marcador seguimiento de eventos para Windows (ETW). Opcionalmente, se implementa mediante windows Display Driver Model (WDDM) 1.3 y controladores posteriores que se ejecutan en el hardware de Microsoft Direct3D Level 9. (Consulte los requisitos en mejoras de rendimiento de representación de Direct3D). Para hardware más avanzado, los controladores deben implementar la función SetMarkerMode .

Sintaxis

PFND3DDDI_SETMARKERMODE Pfnd3dddiSetmarkermode;

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

Parámetros

hDevice

Identificador del dispositivo de visualización (contexto de gráficos).

Type

Valor de la enumeración D3DDDI_MARKERTYPE que indica el tipo de evento de marcador que el controlador debe admitir.

Flags

Valor UINT que indica si el controlador debe proporcionar información personalizada en los búferes de comandos. Si se establece en D3DDDI_SETMARKERMODE_CUSTOMDRIVEREVENTS, el controlador debe anotar e instrumentar búferes de comandos con información de evento personalizada. De lo contrario, el controlador no debe anotar los búferes de comandos.

La anotación puede estar en forma de una cadena de texto en la configuración regional inglés-US o en forma de un valor de índice en una ubicación de una tabla de cadenas. Para esta última opción, el controlador también debe implementar una función que describa las cadenas que indican los valores de índice.

Valor devuelto

Devuelve S_OK o un resultado de error adecuado si la función no se completa correctamente.

Comentarios

Siga estas instrucciones al configurar eventos de marcador de tipo de perfil en el controlador en modo de usuario, indicados por el tipo de D3DDDIMT_PROFILE :

  1. Use instrumentación ligera que no genere una correlación fuerte con los límites de comandos de gráficos.
  2. El controlador debe poder muestrear la marca de tiempo de GPU al final de la canalización de gráficos.
  3. No use comandos de muestreo que coloquen una carga de alto rendimiento en la canalización de gráficos, como los comandos wait-for-idle. Para poder instrumentar eventos de marcador de tipo de perfil, el controlador no debe tener que vaciar la canalización ni las memorias caché.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 8.1,WDDM 1.3 y versiones posteriores
Servidor mínimo compatible Windows Server 2012 R2
Plataforma de destino Escritorio
Encabezado d3dumddi.h (incluya D3d10umddi.h)

Consulte también

D3DDDI_MARKERTYPE

SetMarkerMode