PFND3DWDDM1_3DDI_SETMARKERMODE función de devolución de llamada (d3d10umddi.h)

Notifica al controlador de pantalla en modo de usuario que debe admitir un tipo de evento de marcador seguimiento de eventos para Windows (ETW). Debe implementarse mediante windows Display Driver Model (WDDM) 1.3 y controladores posteriores.

Sintaxis

PFND3DWDDM1_3DDI_SETMARKERMODE Pfnd3dwddm13DdiSetmarkermode;

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

Parámetros

hDevice

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

Type

Valor de la enumeración D3DWDDM1_3DDI_MARKER_TYPE 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 D3DWDDM1_3DDI_SETMARKERMODE_CUSTOMDRIVEREVENTS, el controlador debe anotar e instrumentar los 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

None

Observaciones

El controlador puede usar la función de devolución de llamada pfnSetErrorCb para establecer un código de error.

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

• Use instrumentación ligera que no genere una correlación fuerte con los límites de comandos de gráficos.
• El controlador debe poder muestrear la marca de tiempo de GPU al final de la canalización de gráficos.
• 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	d3d10umddi.h (incluya D3d10umddi.h)

Consulte también

D3DWDDM1_3DDI_MARKER_TYPE