estructura DXGK_HISTORY_BUFFER_HEADER (d3dkmddi.h)

Especifica cómo se almacenan los datos en un búfer de historial de DXGK_HISTORY_BUFFER .

Sintaxis

typedef struct _DXGK_HISTORY_BUFFER_HEADER {
  UINT32 RenderCbSequence;
  UINT32 NumTimestamps;
  UINT32 PrivateDataSize;
  UINT32 Reserved;
} DXGK_HISTORY_BUFFER_HEADER;

Miembros

RenderCbSequence

Valor del D3DDDICB_RENDERFLAGS. Miembro de valor que se va a usar en una llamada a la función pfnRenderCb .

El controlador de minipuerto de pantalla debe calcular este valor y escribirlo en DXGK_HISTORY_BUFFER_HEADER antes de llamar a pfnRenderCb.

NumTimestamps

Número de marcas de tiempo que estarán en el búfer del historial cuando el búfer DMA complete su ejecución.

El controlador debe incluir todas las marcas de tiempo registradas, incluso si el búfer debe tener formato antes de registrarse en la instalación de Seguimiento de eventos para Windows (ETW).

PrivateDataSize

Tamaño, en bytes, de datos privados opcionales que almacena el controlador. El controlador puede usar estos datos para cualquier propósito.

Si es cero, el controlador no necesita almacenar datos privados en el búfer del historial.

Nota Este valor debe ser un múltiplo de 8 bytes para asegurarse de que los datos de marca de tiempo están alineados con un límite de 64 bits.

 

Si no es necesario dar formato al búfer de historial cuando el búfer DMA completa su ejecución, cuando el subsistema del kernel de gráficos de DirectX escribe registros en ETW, usa PrivateDataSize como desplazamiento directo del encabezado para hacer referencia a las marcas de tiempo.

Reserved

Reservado para uso del sistema y debe establecerse en cero.

Comentarios

Solo la parte de marca de tiempo del búfer de historial, junto con el número de marcas de tiempo, se registrará en ETW. Los datos de encabezado y los datos del controlador privado no se registrarán en ETW como parte del búfer de marca de tiempo. Sin embargo, las partes del encabezado se registrarán por separado.

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

D3DDDICB_RENDERFLAGS

DXGK_HISTORY_BUFFER

pfnRenderCb