VideoPortLogError 函式 (video.h)
當迷你埠驅動程式在 I/O 作業期間偵測到硬體錯誤狀況時,VideoPortLogError 函式會將錯誤記錄至系統事件記錄檔。
語法
VIDEOPORT_API VOID VideoPortLogError(
PVOID HwDeviceExtension,
PVIDEO_REQUEST_PACKET Vrp,
VP_STATUS ErrorCode,
ULONG UniqueId
);
參數
HwDeviceExtension
迷你埠驅動程式裝置延伸模組的指標。
Vrp
[選擇性]如果影片要求封包 (VRP) 與錯誤相關聯,則為 [VIDEO_REQUEST_PACKET] 結構的指標;否則為 NULL。
ErrorCode
指定迷你埠驅動程式定義的錯誤碼,指出硬體錯誤的類型。
UniqueId
指定錯誤的唯一識別碼。 這個值會區分目前錯誤與其他錯誤,ErrorCode相同。 對於某些迷你埠驅動程式,這會識別偵測到錯誤的程式代碼行;對其他人而言,它是硬體所傳回的值。
傳回值
沒有
言論
Miniport 驅動程式應該呼叫 VideoPortLogError,以在驅動程式在正常作業期間遇到不尋常的硬體錯誤時通知使用者。 將這類錯誤張貼至系統事件記錄檔會警告用戶視訊配接器可能失敗,讓使用者可以在發生硬體總失敗之前取代或重新設定適配卡。
不過,迷你埠驅動程序應該 不要 記錄錯誤,例如「無法偵測到硬體」,這些錯誤會在正常作業期間經常發生。
VideoPortLogError 可以從迷你埠驅動程式的 HwVidInterrupt 或 HwVidSynchronizeExecutionCallback 函式呼叫。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Windows 2000 |
目標平臺 | 桌面 |
標頭 | video.h (include Video.h) |
連結庫 | Videoprt.lib |
DLL | Videoprt.sys |
IRQL | <= DIRQL |