struttura DXGKARG_COLLECTDBGINFO2 (d3dkmddi.h)
La struttura DXGKARG_COLLECTDBGINFO descrive le informazioni per un report di debug quando viene chiamato DxgkDdiCollectDbgInfo2 .
Sintassi
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;
Members
Reason
[in] Codice di controllo dei bug a cui restituire le informazioni di debug nel buffer a cui punta pBuffer . Questi sono i valori possibili:
| Valore | Significato |
|---|---|
| VIDEO_TDR_TIMEOUT_DETECTED 0x117 | Un'operazione DxgkDdiResetEngine ha reimpostato una scheda logica. |
| VIDEO_ENGINE_TIMEOUT_DETECTED 0x141 | Un'operazione DxgkDdiResetEngine ha reimpostato uno o più nodi all'interno di una scheda fisica. Disponibile a partire da Windows 8. |
pBuffer
[out] Puntatore a un buffer che riceve le informazioni di debug per il motivo specificato da Reason .
BufferSize
Dimensione massima, in byte, da copiare nel buffer a cui punta pBuffer .
pExtension
Puntatore a una struttura di DXGKARG_COLLECTDBGINFO_EXT allocata dal sistema operativo che il driver popola facoltativamente con informazioni sull'estensione di debug.
TdrType
[in] Valore DXGK_TDR_TYPE che specifica il tipo di TDR che si è verificato.
TdrPayloadSize
[in] Dimensioni, in byte, del payload TDR a cui punta TdrPayload .
TdrPayload
[in] Puntatore a un buffer che contiene il payload specifico per determinati valori TdrType , come indicato nella tabella seguente. Questo buffer può essere NULL.
| TdrType | Struttura associata |
|---|---|
| DXGK_TDR_TYPE_ENGINE_TIMEOUT | TdrPayload punta a una struttura DXGK_TDR_PAYLOAD_ENGINE_TIMEOUT . |
| DXGK_TDR_TYPE_VSYNC_TIMEOUT | TdrPayload punta a una struttura DXGK_TDR_PAYLOAD_VSYNC_TIMEOUT . |
Commenti
Il layout di DXGKARG_COLLECTDBGINFO2 è compatibile con le versioni precedenti con DXGKARG_COLLECTDBGINFO per consentire all'implementazione di DxgkDdiCollectDbgInfo2 di riutilizzare gli helper DxgkDdiCollectDbgInfo in base alle esigenze. Per questo motivo, i campi Reason, pBuffer, BufferSize e pExtension hanno la stessa semantica.
Per alcuni tipi TDR (specificati in TdrType), il sistema operativo fornisce informazioni aggiuntive nel buffer TdrPayload dei byte TdrPayloadSize . Può essere NULL e si prevede che il driver gestisca questo caso senza arrestarsi in modo anomalo.
Quando il payload non è NULL, può essere eseguito il cast a una struttura che corrisponde al tipo TDR. Il sistema operativo potrebbe aumentare queste strutture in modo compatibile con le versioni precedenti, aggiungendo nuovi campi alla fine. Il driver deve controllare TdrPayloadSize prima di accedere ai campi TdrPayload per assicurarsi che il sistema operativo implementi la versione del payload desiderata o successiva.
La memoria a cui punta TdrPayload è valida solo per la durata della chiamata DxgkddiCollectDbgInfo2 . Il driver non deve archiviare un puntatore a TdrPayload oltre la fine della chiamata a DxgkddiCollectDbgInfo2 .
Per altre informazioni, vedere Miglioramenti del debug TDR.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 11 versione 24H2 (WDDM 3.2) |
| Intestazione | d3dkmddi.h |