Fungsi VideoPortLogError (video.h)
Fungsi VideoPortLogError mencatat kesalahan ke log peristiwa sistem ketika driver miniport mendeteksi kondisi kesalahan perangkat keras selama operasi I/O.
Sintaks
VIDEOPORT_API VOID VideoPortLogError(
PVOID HwDeviceExtension,
PVIDEO_REQUEST_PACKET Vrp,
VP_STATUS ErrorCode,
ULONG UniqueId
);
Parameter
HwDeviceExtension
Arahkan ke ekstensi perangkat driver miniport.
Vrp
[opsional] Penunjuk ke struktur [VIDEO_REQUEST_PACKET] yang menjelaskan paket permintaan video (VRP) jika dikaitkan dengan kesalahan; jika tidak, NULL.
ErrorCode
Menentukan kode kesalahan yang ditentukan driver miniport yang menunjukkan jenis kesalahan perangkat keras.
UniqueId
Menentukan pengidentifikasi unik untuk kesalahan tersebut. Nilai ini membedakan kesalahan saat ini dari kesalahan lain dengan ErrorCode yang sama. Untuk beberapa driver miniport, ini mengidentifikasi baris kode tempat kesalahan terdeteksi; untuk yang lain, ini adalah nilai yang dikembalikan oleh perangkat keras.
Nilai kembali
Tidak ada
Keterangan
Driver miniport harus memanggil VideoPortLogError untuk memberi tahu pengguna jika driver mengalami kesalahan perangkat keras yang tidak biasa selama operasi normal. Memposting kesalahan tersebut ke log peristiwa sistem memperingatkan pengguna bahwa adaptor video mungkin gagal sehingga pengguna dapat mengganti (atau mengonfigurasi ulang) adaptor sebelum kegagalan perangkat keras total terjadi.
Namun, driver miniport tidak boleh mencatat kesalahan, seperti "gagal mendeteksi perangkat keras," yang sering terjadi selama operasi normal.
VideoPortLogError dapat dipanggil dari fungsi HwVidInterrupt atau HwVidSynchronizeExecutionCallback driver miniport.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows 2000 |
Target Platform | Desktop |
Header | video.h (sertakan Video.h) |
Pustaka | Videoprt.lib |
DLL | Videoprt.sys |
IRQL | <= DIRQL |