Compartir a través de

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

  • Artículo

Notifica al controlador de pantalla en modo de usuario que debe generar una nueva marca de tiempo si se ha completado algún trabajo de GPU desde la última llamada a pfnSetMarker. Opcionalmente, implementado por windows Display Driver Model (WDDM) 1.3 y controladores posteriores que se ejecutan en el hardware de Nivel 9 de Microsoft Direct3D. (Consulte los requisitos en Mejoras de rendimiento de representación de Direct3D). Para hardware más avanzado, los controladores deben implementar la función SetMarker .

Sintaxis

PFND3DDDI_SETMARKER Pfnd3dddiSetmarker;

HRESULT Pfnd3dddiSetmarker(
  HANDLE hDevice
)
{...}

Parámetros

hDevice

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

Valor devuelto

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

Comentarios

Si el tipo de evento de marcador del parámetro Type de la función pfnSetMarkerMode no es D3DDDIMT_NONE, el controlador de pantalla en modo de usuario debe realizar este procedimiento con cada llamada a pfnSetMarker:

  1. Incremente el valor del miembro APISequenceNumber de la estructura D3DDDICB_LOGUMDMARKER .
  2. Determine qué contextos asociados a la interfaz de controlador de dispositivo (DDI) de un solo subproceso representan las llamadas enviadas al trabajo con la última llamada a pfnSetMarker. Para cada contexto de este tipo:
    1. Si el búfer de comandos del contexto está vacío, no haga nada.
    2. De lo contrario:
      • Asegúrese de que haya más memoria disponible en el búfer de historial del contexto. Vacíe el búfer si es necesario.
      • Agregue otra entrada al búfer de número de secuencia de API del contexto que contiene los 32 bits bajos del valor de APISequenceNumber actual.
      • Muestra y escribe marcas de tiempo adecuadas para el tipo de evento de marcador actual.
    3. Actualice los datos de seguimiento que se usarán la próxima vez que se llame a pfnSetMarker .

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

SetMarker

pfnSetMarkerMode