PVIDEO_BUGCHECK_CALLBACK fungsi panggilan balik (video.h)
Fungsi HwVidBugcheckCallback memungkinkan driver miniport menambahkan data ke file cadangan saat pemeriksaan bug terjadi.
Sintaks
PVIDEO_BUGCHECK_CALLBACK PvideoBugcheckCallback;
void PvideoBugcheckCallback(
[in] IN PVOID HwDeviceExtension,
[in] IN ULONG BugcheckCode,
[in] IN PUCHAR Buffer,
[in] IN ULONG BufferSize
)
{...}
Parameter
[in] HwDeviceExtension
Arahkan ke area penyimpanan per adaptor driver miniport. Untuk informasi selengkapnya, lihat Ekstensi Perangkat.
[in] BugcheckCode
Menentukan kode pemeriksaan bug.
[in] Buffer
Arahkan ke lokasi memori tempat driver miniport dapat menyimpan data yang akan ditambahkan ke file cadangan.
[in] BufferSize
Menentukan ukuran, dalam byte, dari buffer yang diacu oleh parameter Buffer .
Menampilkan nilai
Tidak ada
Keterangan
Fungsi ini tersedia di Windows XP SP1 dan yang lebih baru.
Fungsi ini dipanggil ketika pemeriksaan bug terjadi. Driver miniport dapat mengumpulkan data yang akan ditambahkan ke file cadangan dan menulis data ini ke buffer. Driver tidak boleh menulis lebih dari byte BufferSize ke buffer.
Driver miniport video mendaftarkan fungsi HwVidBugcheckCallback dengan memanggil fungsi VideoPortRegisterBugcheckCallback . Fungsi VideoPortRegisterBugcheckCallback mengekspos panggilan balik yang disediakan driver miniport video ini ke sistem.
Untuk memfasilitasi pemulihan sistem setelah pemeriksaan bug, setiap register yang diakses oleh fungsi ini tidak boleh menghambat kemampuan perangkat keras untuk mentransfer ke mode fallback, terlepas dari keadaan perangkat. Selain itu, fungsi harus mengembalikan kontrol ke pemanggilnya.
Karena sistem dapat terdiri dari beberapa driver miniport video, vendor harus menambahkan string identifikasi ke data yang ditambahkan fungsi ini ke file cadangan.
Fungsi ini dipanggil pada IRQL yang dinaikkan dan tidak boleh mencoba mengakses kode atau data yang dapat dipaginasi.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Target Platform | Desktop |
| Header | video.h (sertakan Video.h) |