次の方法で共有

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 で呼び出され、ページング可能なコードまたはデータへのアクセスを試みてはなりません。

必要条件

要件 価値
ターゲット プラットフォーム の デスクトップ
ヘッダー video.h (Video.h を含む)

関連項目

VideoPortRegisterBugcheckCallback の