estructura DXGKARG_COLLECTDBGINFO2 (d3dkmddi.h)

Artículo
05/23/2024

La estructura DXGKARG_COLLECTDBGINFO describe información de un informe de depuración cuando se llama a DxgkDdiCollectDbgInfo2 .

Sintaxis

typedef struct _DXGKARG_COLLECTDBGINFO2 {
  UINT                       Reason;
  VOID                       *pBuffer;
  SIZE_T                     BufferSize;
  DXGKARG_COLLECTDBGINFO_EXT *pExtension;
  DXGK_TDR_TYPE              TdrType;
  UINT                       TdrPayloadSize;
  VOID                       *TdrPayload;
} DXGKARG_COLLECTDBGINFO2;

Miembros

Reason

[in] Código de comprobación de errores al que se va a devolver información de depuración en el búfer al que apunta pBuffer . Estos son valores posibles:

Valor	Significado
VIDEO_TDR_TIMEOUT_DETECTED 0x117	Una operación DxgkDdiResetEngine ha restablecido un adaptador lógico.
VIDEO_ENGINE_TIMEOUT_DETECTED 0x141	Una operación DxgkDdiResetEngine ha restablecido uno o varios nodos dentro de un adaptador físico. Disponible a partir de Windows 8.

pBuffer

[out] Puntero a un búfer que recibe la información de depuración por el motivo que especifica Reason .

BufferSize

Tamaño máximo, en bytes, al que se va a copiar el búfer al que apunta pBuffer .

pExtension

Puntero a una estructura de DXGKARG_COLLECTDBGINFO_EXT asignada por el sistema operativo que el controlador rellena opcionalmente con información de extensión de depuración.

TdrType

[in] Valor DXGK_TDR_TYPE que especifica el tipo de TDR que se produjo.

TdrPayloadSize

[in] Tamaño, en bytes, de la carga de TDR a la que apunta TdrPayload .

TdrPayload

[in] Puntero a un búfer que contiene la carga específica de determinados valores TdrType , como se indica en la tabla siguiente. Este búfer puede ser NULL.

TdrType	Estructura asociada
DXGK_TDR_TYPE_ENGINE_TIMEOUT	TdrPayload apunta a una estructura de DXGK_TDR_PAYLOAD_ENGINE_TIMEOUT .
DXGK_TDR_TYPE_VSYNC_TIMEOUT	TdrPayload apunta a una estructura de DXGK_TDR_PAYLOAD_VSYNC_TIMEOUT .

Comentarios

El diseño de DXGKARG_COLLECTDBGINFO2 es compatible con versiones anteriores con DXGKARG_COLLECTDBGINFO para permitir que la implementación dxgkDdiCollectDbgInfo2 vuelva a usar los asistentes de DxgkDdiCollectDbgInfo existentes según sea necesario. Por este motivo, los campos Reason, pBuffer, BufferSize y pExtension tienen la misma semántica.

Para algunos tipos de TDR (especificados en TdrType), el sistema operativo proporciona información adicional en el búfer TdrPayload de bytes TdrPayloadSize . Puede ser NULL y se espera que el controlador controle este caso sin bloqueos.

Cuando la carga no es NULL, se puede convertir en una estructura que se corresponda con el tipo de TDR. El sistema operativo podría aumentar estas estructuras de forma compatible con versiones anteriores, agregando nuevos campos al final. El controlador debe comprobar TdrPayloadSize antes de acceder a los campos de TdrPayload para asegurarse de que el sistema operativo implementa la versión de carga deseada o posterior.

La memoria a la que apunta TdrPayload solo es válida durante la llamada a DxgkddiCollectDbgInfo2 . El controlador no debe almacenar un puntero a TdrPayload más allá del final de la llamada a DxgkddiCollectDbgInfo2 .

Para más información, consulte Mejoras de depuración de TDR.