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 cualquier 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 hardware de Microsoft Direct3D Level 9. (Consulte los requisitos de mejoras en el rendimiento de la representación de Direct3D). Para un 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.

Observaciones

Si el tipo de evento de marcador del parámetro Type del 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 de 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 enviado 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 otra manera:
      • Asegúrese de que haya más memoria disponible en el búfer del historial del contexto. Vaciar 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 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 Valor
cliente mínimo admitido Windows 8.1,WDDM 1.3 y versiones posteriores
servidor mínimo admitido Windows Server 2012 R2
de la plataforma de destino de Escritorio
encabezado de d3dumddi.h (incluya D3d10umddi.h)

Consulte también

SetMarker

pfnSetMarkerMode