struktur DXGKARG_COLLECTDBGINFO2 (d3dkmddi.h)
Struktur DXGKARG_COLLECTDBGINFO menjelaskan informasi untuk laporan debug saat DxgkDdiCollectDbgInfo2 dipanggil.
Sintaks
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;
Anggota
Reason
[in] Kode pemeriksaan bug untuk mengembalikan informasi debug di buffer yang dirujuk pBuffer . Ini adalah nilai yang mungkin:
| Nilai | Makna |
|---|---|
| VIDEO_TDR_TIMEOUT_DETECTED 0x117 | Operasi DxgkDdiResetEngine telah mengatur ulang adaptor logis. |
| 0x141 VIDEO_ENGINE_TIMEOUT_DETECTED | Operasi DxgkDdiResetEngine telah mengatur ulang satu atau beberapa simpul dalam adaptor fisik. Tersedia mulai dari Windows 8. |
pBuffer
[keluar] Penunjuk ke buffer yang menerima informasi debug karena alasan yang ditentukan Alasan .
BufferSize
Ukuran maksimum, dalam byte, untuk menyalin ke buffer tempat pBuffer menunjuk.
pExtension
Penunjuk ke struktur DXGKARG_COLLECTDBGINFO_EXT yang dialokasikan OS yang secara opsional diisi driver dengan informasi ekstensi debug.
TdrType
[in] Nilai DXGK_TDR_TYPE yang menentukan jenis TDR yang terjadi.
TdrPayloadSize
[in] Ukuran, dalam byte, dari payload TDR yang ditolak TdrPayload .
TdrPayload
[in] Penunjuk ke buffer yang berisi payload khusus untuk nilai TdrType tertentu, seperti yang ditunjukkan pada tabel berikut. Buffer ini bisa NULL.
| TdrType | Struktur terkait |
|---|---|
| DXGK_TDR_TYPE_ENGINE_TIMEOUT | TdrPayload menunjuk ke struktur DXGK_TDR_PAYLOAD_ENGINE_TIMEOUT . |
| DXGK_TDR_TYPE_VSYNC_TIMEOUT | TdrPayload menunjuk ke struktur DXGK_TDR_PAYLOAD_VSYNC_TIMEOUT . |
Keterangan
Tata letak DXGKARG_COLLECTDBGINFO2 kompatibel mundur dengan DXGKARG_COLLECTDBGINFO untuk memungkinkan implementasi DxgkDdiCollectDbgInfo2 menggunakan kembali pembantu DxgkDdiCollectDbgInfo yang ada sesuai kebutuhan. Untuk alasan ini, bidang Reason, pBuffer, BufferSize, dan pExtension memiliki semantik yang sama.
Untuk beberapa jenis TDR (ditentukan dalam TdrType), OS menyediakan informasi tambahan dalam buffer TdrPayload byte TdrPayloadSize . Ini bisa NULL, dan driver diharapkan untuk menangani kasus ini tanpa crash.
Ketika payload bukan NULL, payload dapat ditransmisikan ke struktur yang sesuai dengan jenis TDR. OS mungkin menumbuhkan struktur ini dengan cara yang kompatibel ke belakang, menambahkan bidang baru di akhir. Driver harus memeriksa TdrPayloadSize sebelum mengakses bidang TdrPayload untuk memastikan OS mengimplementasikan versi payload yang diinginkan atau yang lebih baru.
Memori yang dituju TdrPayload hanya valid selama durasi panggilan DxgkddiCollectDbgInfo2 . Driver tidak boleh menyimpan pointer ke TdrPayload melewati akhir panggilan DxgkddiCollectDbgInfo2 .
Untuk informasi selengkapnya, lihat Peningkatan debugability TDR.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows 11, versi 24H2 (WDDM 3.2) |
| Header | d3dkmddi.h |