PVIDEO_BUGCHECK_CALLBACK コールバック関数 (video.h)

HwVidBugcheckCallback 関数を使用すると、バグ チェックが発生したときに、ミニポート ドライバーがダンプ ファイルにデータを追加できます。

構文

PVIDEO_BUGCHECK_CALLBACK PvideoBugcheckCallback;

void PvideoBugcheckCallback(
  [in] IN PVOID HwDeviceExtension,
  [in] IN ULONG BugcheckCode,
  [in] IN PUCHAR Buffer,
  [in] IN ULONG BufferSize
)
{...}

パラメーター

[in] HwDeviceExtension

ミニポート ドライバーのアダプターごとの記憶域へのポインター。 詳細については、「 デバイス拡張機能」を参照してください。

[in] BugcheckCode

コードのバグチェック指定します。

[in] Buffer

ミニポート ドライバーがダンプ ファイルに追加されるデータを格納できるメモリの場所へのポインター。

[in] BufferSize

Buffer パラメーターが指すバッファーのサイズをバイト単位で指定します。

戻り値

なし

解説

この関数は、Windows XP SP1 以降で使用できます。

この関数は、バグ チェックが発生したときに呼び出されます。 ミニポート ドライバーは、ダンプ ファイルに追加するデータを収集し、バッファーにこのデータを書き込むことができます。 ドライバーは 、バッファーに BufferSize バイトを超えるバイトを書き込む必要があります。

ビデオ ミニポート ドライバーは、 VideoPortRegisterBugcheckCallback 関数を呼び出すことによって HwVidBugcheckCallback 関数を 登録します。 VideoPortRegisterBugcheckCallback 関数は、このビデオ ミニポート ドライバー提供のコールバックをシステムに公開します。

バグチェック後のシステム回復を容易にするために、この関数によってアクセスされるレジスタは、デバイスの状態に関係なく、ハードウェアがフォールバック モードに転送する機能を妨げてはなりません。 また、関数は呼び出し元に制御を返す 必要があります 。

システムは複数のビデオ ミニポート ドライバーで構成できるため、ベンダーは、この関数がダンプ ファイルに追加するデータに識別文字列を追加する必要があります。

関数は、発生した IRQL で呼び出され、ページング可能なコードまたはデータへのアクセスを試みてはなりません。

要件

要件	値
対象プラットフォーム	デスクトップ
Header	video.h (Video.h を含む)

こちらもご覧ください

VideoPortRegisterBugcheckCallback