VideoPortLogError 関数 (video.h)

VideoPortLogError 関数は、ミニポート ドライバーが I/O 操作中にハードウェア エラー状態を検出したときに、システム イベント ログにエラーを記録します。

構文

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 関数から呼び出すことができます。

要件

こちらもご覧ください

VideoDebugPrint