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) |