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 的其他錯誤區別。 對於某些迷你埠驅動程式，這會識別偵測到錯誤的程式代碼行;對於其他人而言，它是硬體所傳回的值。

傳回值

無

備註

迷你埠驅動程序應該呼叫 VideoPortLogError ，以在正常作業期間遇到不尋常的硬體錯誤時通知使用者。 將這類錯誤張貼至系統事件記錄檔會警告用戶視訊適配卡可能會失敗，讓使用者可以在發生總硬體失敗之前取代 (或重新設定) 適配卡。

不過，迷你埠驅動程序 不應該 記錄錯誤，例如「無法偵測硬體」，這些錯誤會在正常作業期間經常發生。

VideoPortLogError 可以從迷你埠驅動程式的 HwVidInterrupt 或 HwVidSynchronizeExecutionCallback 函式呼叫。

規格需求

需求 值
最低支援的用戶端 Windows 2000
目標平台 桌面
標頭 video.h (包含 Video.h)
程式庫 Videoprt.lib
Dll Videoprt.sys
IRQL <= DIRQL

另請參閱

VideoDebugPrint