共用方式為


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 可以從迷你埠驅動程式的 HwVidInterruptHwVidSynchronizeExecutionCallback 函式呼叫。

要求

要求 價值
最低支援的用戶端 Windows 2000
目標平臺 桌面
標頭 video.h (include Video.h)
連結庫 Videoprt.lib
DLL Videoprt.sys
IRQL <= DIRQL

另請參閱

VideoDebugPrint