DXGKDDI_COLLECTDBGINFO2 fungsi panggilan balik (d3dkmddi.h)
Fungsi DxgkDdiCollectDbgInfo2 menghasilkan informasi driver untuk laporan debug.
Sintaks
DXGKDDI_COLLECTDBGINFO2 DxgkddiCollectdbginfo2;
NTSTATUS DxgkddiCollectdbginfo2(
IN_CONST_HANDLE hAdapter,
INOUT_PDXGKARG_COLLECTDBGINFO2 pCollectDbgInfo2
)
{...}
Parameter
hAdapter
[in] Handel ke blok konteks yang terkait dengan adaptor tampilan. Tampilan miniport (KMD) sebelumnya menyediakan handel ini ke Dxgkrnl di parameter output MiniportDeviceContext dari DxgkDdiAddDevice.
pCollectDbgInfo2
[masuk/keluar] Penunjuk ke struktur DXGKARG_COLLECTDBGINFO2 yang berisi informasi untuk laporan debug.
Menampilkan nilai
DxgkDdiCollectDbgInfo2 mengembalikan salah satu nilai berikut:
| Menampilkan kode | Deskripsi |
|---|---|
| STATUS_SUCCESS | DxgkDdiCollectDbgInfo2 berhasil menghasilkan informasi driver untuk laporan debug; ATAU, OS mengabaikan konten dalam buffer yang dituju pBuffer dan tidak menambahkan informasi dari DxgkDdiCollectDbgInfo2 ke laporan debug. |
| STATUS_NO_MEMORY | DxgkDdiCollectDbgInfo2 tidak dapat mengalokasikan memori yang diperlukan untuk menyelesaikannya. |
| STATUS_UNSUCCESSFUL | Kesalahan lain mencegah driver mengumpulkan informasi debug yang valid. |
Keterangan
Dxgkrnl memanggil fungsi DxgkDdiCollectDbgInfo2 KMD setiap kali OS akan menghasilkan laporan debug terkait driver. DxgkDdiCollectDbgInfo2 mungkin dipanggil segera sebelum Timeout Detection and Recovery (TDR) berfungsi atau segera sebelum pemeriksaan bug OS. Meskipun DxgkDdiCollectDbgInfo2 harus kembali secepat mungkin, tidak ada jumlah waktu maksimum yang ditentukan sistem yang dapat dihabiskan driver dalam fungsi ini.
DxgkDdiCollectDbgInfo2 menerima informasi lebih rinci tentang akar penyebab TDR daripada yang dilakukan DxgkDdiCollectDbgInfo . KMD dapat menyimpan status yang relevan dengan bagian GPU yang bertanggung jawab atas TDR.
- Driver WDDM 3.2 tidak diperlukan untuk mengimplementasikan DxgkddiCollectDbgInfo2, dalam hal ini OS memanggil DxgkddiCollectDbgInfo.
KMD harus mengumpulkan informasi debug. Ketika DxgkDdiCollectDbgInfo2 dipanggil, driver menerima kode pemeriksaan bug di pCollectDbgInfo2-Reason> yang menunjukkan jenis informasi yang diperlukan untuk laporan debug. Driver menyalin informasi debug yang diperlukan ke dalam buffer yang ditunjuk pCollectDbgInfo2-pBuffer>. Jumlah maksimum byte informasi yang dapat disalin driver ditentukan oleh pCollectDbgInfo2-BufferSize>.
DxgkDdiCollectDbgInfo umumnya berjalan pada IRQL yang tidak terdefinisi. Namun, jika pCollectDbgInfo2-Reason> diatur ke VIDEO_TDR_TIMEOUT_DETECTED (untuk menunjukkan reset di seluruh adaptor) atau VIDEO_ENGINE_TIMEOUT_DETECTED (tersedia dimulai dengan Windows 8 untuk menunjukkan reset satu atau beberapa node dalam adaptor fisik), driver harus memastikan bahwa DxgkDdiCollectDbgInfo2 dapat dipaginasi, berjalan di IRQL = PASSIVE_LEVEL, dan mendukung tingkat nol sinkronisasi.
Untuk informasi selengkapnya, lihat Peningkatan debugability TDR.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows 11, versi 24H2 (WDDM 3.2) |
| Header | d3dkmddi.h |
| IRQL | PASSIVE_LEVEL (Lihat Keterangan) |