struktur DXGKARG_COLLECTDIAGNOSTICINFO (dispmprt.h)

Artikel
02/23/2024

Digunakan oleh fungsi panggilan balik DXGKDDI_COLLECTDIAGNOSTICINFO untuk mengumpulkan informasi driver pribadi karena berbagai alasan.

Misalnya, OS akan memanggil fungsi panggilan balik DXGKDDI_COLLECTDIAGNOSTICINFO saat informasi diagnostik diperlukan, sambil memberikan jenis informasi yang diminta (DXGK_DIAGNOSTICINFO_TYPE). Driver harus mengumpulkan semua informasi pribadi untuk menyelidiki masalah dan mengirimkannya ke OS.

Sintaks

typedef struct _DXGKARG_COLLECTDIAGNOSTICINFO {
  [in, optional]  HANDLE                   hAdapter;
  [in]            DXGK_DIAGNOSTICINFO_TYPE Type;
                  CHAR                     BucketingString[DXGK_DUMP_BUCKETING_BUFFER_SIZE];
                  CHAR                     DescriptionString[DXGK_DUMP_DESCRIPTION_BUFFER_SIZE];
  union {
    [out, optional] PVOID pReserved;
  };
  [in]            UINT                     BufferSizeIn;
  [out]           UINT                     BufferSizeOut;
  [out]           PVOID                    pBuffer;
} DXGKARG_COLLECTDIAGNOSTICINFO;

Anggota

[in, hAdapter

Handel ke blok konteks yang terkait dengan adaptor tampilan.

Sebelum WDDM 2.6, fungsi DxgkDdiAddDevice driver miniport memberikan handel ini ke subsistem kernel grafis DirectX. Parameter ini bersifat opsional dan dapat berupa NULL jika driver gagal memberikan handel ke OS.

[in] Type

Nilai enumerasi DXGK_DIAGNOSTICINFO_TYPE yang menunjukkan jenis informasi yang perlu dikumpulkan driver.

[out] BucketingString[DXGK_DUMP_BUCKETING_BUFFER_SIZE]

Buffer ukuran tetap disediakan untuk string yang harus digunakan driver untuk mengidentifikasi masalah untuk tujuan bucketing. String ini harus konsisten antara versi driver untuk masalah yang sama sehingga tidak boleh berisi elemen seperti referensi sumber, versi driver, atau detail spesifik instans seperti nomor pagar atau id target. Ini mungkin berisi informasi seperti pengidentifikasi sub-komponen internal yang gagal, atau nama modul, misalnya mismatched_driver_ihvxseries.sys. Kode yang valid adalah 0x21-0x7E dan garis bawah (0x5f) harus digunakan alih-alih spasi (0x20).

[out, DescriptionString[DXGK_DUMP_DESCRIPTION_BUFFER_SIZE]

Buffer ukuran tetap yang disediakan untuk string yang harus digunakan driver untuk menjelaskan detail spesifik instans yang tidak digunakan untuk bucketing, tetapi dapat digunakan untuk memberikan detail selengkapnya tentang masalah tertentu, misalnya mismatched_driver_versions_kmd_10.22.1111.1121,_ihvxseries:10.22.1111.1122. Kode yang valid adalah 0x21-0x7E dan garis bawah (0x5f) harus digunakan alih-alih spasi (0x20).

[out, pReserved

Penunjuk ke VOID dalam gabungan yang tidak disebutkan namanya yang dicadangkan sebagai tempat penampung untuk penunjuk ke argumen khusus jenis yang mungkin disediakan OS untuk beberapa Jenis. Nilai ini adalah NULL untuk Jenis yang tidak memerlukan informasi yang diperluas.

[in] BufferSizeIn

Variabel yang menyediakan ukuran, dalam byte, dari buffer yang dialokasikan OS. Untuk nilai JenisDXGK_DI_ADDDEVICE dan DXGK_DI_STARTDEVICE ukurannya akan berada di sekitar 0x80000.

[out] BufferSizeOut

Variabel yang harus diperbarui driver dengan ukuran aktual yang diisi dengan data privatnya. Jika tidak ada data privat yang disediakan, driver harus menetapkan 0 ke variabel .

[out] pBuffer

Penunjuk ke buffer yang menerima data driver privat.