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

Lihat juga

VideoDebugPrint