estructura DXGKARG_FORMATHISTORYBUFFER (d3dkmddi.h)

Contiene información para que el controlador de minipuerto de pantalla dé formato a un búfer de historial.

Sintaxis

typedef struct _DXGKARG_FORMATHISTORYBUFFER {
  DXGK_HISTORY_BUFFER            *pHistoryBuffer;
  UINT32                         HistoryBufferSize;
  PVOID                          pFormattedBuffer;
  UINT32                         FormattedBufferSize;
  UINT32                         NumTimestamps;
  DXGKARG_HISTORYBUFFERPRECISION Precision;
  UINT32                         Offset;
} DXGKARG_FORMATHISTORYBUFFER;

Miembros

pHistoryBuffer

Puntero al búfer de historial de DXGK_HISTORY_BUFFER sin formato que ha rellenado la GPU.

HistoryBufferSize

Tamaño, en bytes, del búfer al que apunta pHistoryBuffer.

pFormattedBuffer

Puntero a un segmento de memoria del sistema no paginada que el controlador usa para almacenar la información de marca de tiempo que deriva del búfer de historial sin formato proporcionado.

El búfer al que apunta pFormattedBuffer debe administrarse como una gran matriz de marcas de tiempo de precisión especificadas por Precision. El búfer no debe contener ninguna información de encabezado que ya exista en el búfer del historial original.

FormattedBufferSize

Tamaño, en bytes, del búfer al que apunta pFormattedBuffer. El controlador debe asegurarse de que no escribe datos más allá de este tamaño de búfer.

NumTimestamps

Número de marcas de tiempo. Al finalizar una llamada a la función DxgkDdiFormatHistoryBuffer , el controlador debe establecer este valor en el número de marcas de tiempo escritas en el búfer con formato al que apunta pFormattedBuffer.

Tenga en cuenta que el número de marcas de tiempo que estarán en el búfer de salida con formato no se conocerá hasta que el controlador complete el búfer con formato al que apunta pFormattedBuffer.

Precision

Estructura DXGKARG_HISTORYBUFFERPRECISION que el controlador rellena con información sobre la precisión de las marcas de tiempo que se registrarán en la instalación seguimiento de eventos para Windows (ETW).

Valor del DXGKARG_HISTORYBUFFERPRECISION. El miembro PrecisionBits no puede ser cero.

Offset

En la entrada de una llamada a la función DxgkDdiFormatHistoryBuffer , el valor de este miembro es el desplazamiento a la primera marca de tiempo en la que se debe iniciar el formato. Al finalizar la llamada de función, el controlador debe establecer el valor en cero si ha dado formato correctamente a todas las marcas de tiempo en el búfer del historial.

Si no es cero, el controlador no pudo dar formato a todas las marcas de tiempo en el búfer del historial sin rellenar el búfer con formato. En este caso, el valor representa el desplazamiento desde el que se debe continuar en la siguiente llamada de función.

Comentarios

El controlador debe obtener entradas de marca de tiempo y el número de marcas de tiempo utilizables del encabezado del búfer de historial proporcionado. Los datos adicionales que el controlador necesita para los cálculos deben almacenarse en datos privados.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 8.1, WDDM 1.3 y versiones posteriores
Servidor mínimo compatible	Windows Server 2012 R2
Encabezado	d3dkmddi.h (incluye D3dkmddi.h)

Consulte también

DXGKARG_HISTORYBUFFERPRECISION

DXGK_HISTORY_BUFFER

DxgkDdiFormatHistoryBuffer