Fungsi VideoPortRegisterBugcheckCallback (video.h)
Fungsi VideoPortRegisterBugcheckCallback memungkinkan driver miniport video untuk mendaftar, atau menghubungkan, panggilan balik yang dipanggil ketika pemeriksaan bug tertentu terjadi.
Sintaks
VIDEOPORT_DEPRECATED VIDEOPORT_API VP_STATUS VideoPortRegisterBugcheckCallback(
[in] IN PVOID HwDeviceExtension,
[in] IN ULONG BugcheckCode,
[in] IN PVIDEO_BUGCHECK_CALLBACK Callback,
[in] IN ULONG BugcheckDataSize
);
Parameter
[in] HwDeviceExtension
Arahkan ke ekstensi perangkat driver miniport.
[in] BugcheckCode
Menunjukkan kode pemeriksaan bug yang akan dipanggil kembali. Saat ini, driver miniport hanya dapat mendaftar untuk kode pemeriksaan bug 0xEA.
[in] Callback
Arahkan ke fungsi HwVidBugcheckCallback driver miniport. Fungsi ini harus tidak di-halaman, dan tidak boleh mereferensikan kode atau data yang dapat di-pageable. Driver miniport dapat mengatur parameter ini ke NULL untuk menunjukkan bahwa panggilan balik pemeriksaan bug harus tidak di-hook.
[in] BugcheckDataSize
Menunjukkan jumlah BUGCHECK_DATA_SIZE_RESERVED dan jumlah byte data yang akan disediakan driver miniport untuk dimasukkan dalam file cadangan. Nilai parameter ini harus kurang dari atau sama dengan 4000. Driver miniport dapat mengatur parameter ini ke nol untuk menunjukkan bahwa panggilan balik pemeriksaan bug harus dilepaskan.
Nilai kembali
VideoPortRegisterBugcheckCallback mengembalikan NO_ERROR jika berhasil. Jika tidak, ia mengembalikan kode status yang menunjukkan sifat kegagalan.
Keterangan
Jika Anda mengembangkan driver miniport video yang dimaksudkan untuk berjalan pada Windows XP atau sistem operasi dasar NT sebelumnya, Anda dapat menggunakan rutinitas panggilan balik VideoPortGetProcAddress untuk menemukan alamat fungsi VideoPortRegisterBugcheckCallback . Untuk detailnya, lihat Menggunakan VideoPortGetProcAddress.
Driver miniport dapat mendaftar untuk panggilan balik ketika jenis pemeriksaan bug tertentu terjadi. Saat ini, hanya kode pemeriksaan bug 0xEA yang dapat dikaitkan. Ketika pemeriksaan bug terjadi, fungsi panggilan balik yang disediakan minidriver dipanggil dan driver miniport dapat menambahkan data ke file cadangan. Ini berguna untuk mengumpulkan data statistik ketika penelusuran kesalahan langsung tidak dimungkinkan.
Nilai parameter BugcheckDataSize harus BUGCHECK_DATA_SIZE_RESERVED byte yang lebih besar dari data yang disediakan oleh driver miniport. Misalnya, driver miniport menyediakan DUMP_SIZE byte data untuk ditulis ke file cadangan. Kemudian nilai BugcheckDataSize harus DUMP_SIZE + BUGCHECK_DATA_SIZE_RESERVED, dan nilai total tersebut harus kurang dari atau sama dengan 4000.
Konstanta BUGCHECK_DATA_SIZE_RESERVED (ditentukan dalam video.h) tersedia di Lingkungan build Microsoft Windows Server 2003 dan yang lebih baru. Di lingkungan build Windows XP SP1, gunakan 48 alih-alih BUGCHECK_DATA_SIZE_RESERVED.
Driver miniport dapat membatalkan pendaftaran panggilan balik yang terdaftar sebelumnya dengan memanggil fungsi ini, menentukan NULL untuk parameter Callback , atau nol untuk parameter DataSize .
Untuk informasi selengkapnya, lihat Dukungan Driver Port Video untuk Panggilan Balik Pemeriksaan Bug.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Tersedia di Windows XP SP1 dan versi yang lebih baru dari sistem operasi Windows. |
| Target Platform | Desktop |
| Header | video.h (sertakan Video.h) |
| Pustaka | Videoprt.lib |
| DLL | Videoprt.sys |
| IRQL | PASSIVE_LEVEL |