次の方法で共有

VideoPortRegisterBugcheckCallback 関数 (video.h)

  • [アーティクル]

VideoPortRegisterBugcheckCallback 関数を使用すると、ビデオ ミニポート ドライバーは、指定されたバグ チェックが発生したときに呼び出されるコールバックを登録またはフックできます。

構文

VIDEOPORT_DEPRECATED VIDEOPORT_API VP_STATUS VideoPortRegisterBugcheckCallback(
  [in] IN PVOID                    HwDeviceExtension,
  [in] IN ULONG                    BugcheckCode,
  [in] IN PVIDEO_BUGCHECK_CALLBACK Callback,
  [in] IN ULONG                    BugcheckDataSize
);

パラメーター

[in] HwDeviceExtension

ミニポート ドライバーのデバイス拡張機能へのポインター。

[in] BugcheckCode

呼び戻すバグ チェック コードを示します。 現在、ミニポート ドライバーは、バグ チェック コードの0xEAにのみ登録できます。

[in] Callback

ミニポート ドライバーの HwVidBugcheckCallback 関数へのポインター。 この関数は非ページであり、ページング可能なコードまたはデータを参照してはなりません。 ミニポート ドライバーは、バグ チェック コールバックをフック解除する必要があることを示す NULL を するこのパラメーターを設定できます。

[in] BugcheckDataSize

BUGCHECK_DATA_SIZE_RESERVEDの合計と、ミニポート ドライバーがダンプ ファイルに含めるために提供するデータのバイト数を示します。 このパラメーターの値は 4000 以下である必要があります。 ミニポート ドライバーは、バグ チェック コールバックをフック解除する必要があることを示す 0 にこのパラメーターを設定できます。

戻り値

VideoPortRegisterBugcheckCallback 成功した場合、NO_ERRORを返します。 それ以外の場合は、エラーの性質を示す状態コードが返されます。

備考

Windows XP または以前の NT ベースのオペレーティング システムで実行することを目的としたビデオ ミニポート ドライバーを開発している場合は、VideoPortGetProcAddress コールバック ルーチン 使用して、VideoPortRegisterBugcheckCallback 関数のアドレスを検索できます。 詳細については、VideoPortGetProcAddress の使用に関するを参照してください。

ミニポート ドライバーは、特定の種類のバグ チェックが発生したときにコールバックを登録できます。 現在、フックできるのはバグ チェック コード0xEA だけです。 バグ チェックが発生すると、ミニドライバーが提供するコールバック関数が呼び出され、ミニポート ドライバーはダンプ ファイルにデータを追加できます。 これは、直接デバッグできない場合に統計データを収集する場合に役立ちます。

BugcheckDataSize パラメーターの値は、ミニポート ドライバーによって提供されるデータよりBUGCHECK_DATA_SIZE_RESERVEDバイト大きい必要があります。 たとえば、ミニポート ドライバーは、ダンプ ファイルに書き込まれるデータのバイトDUMP_SIZE提供します。 次に、BugcheckDataSize の値を DUMP_SIZE + BUGCHECK_DATA_SIZE_RESERVEDにする必要があり、その合計値は 4000 以下である必要があります。

定数BUGCHECK_DATA_SIZE_RESERVED (video.hで定義) は、Microsoft Windows Server 2003 以降のビルド環境で使用できます。 Windows XP SP1 ビルド環境では、BUGCHECK_DATA_SIZE_RESERVEDの代わりに 48 を使用します。

ミニポート ドライバーは、この関数を呼び出して、コールバック パラメーター NULL を指定するか、DataSize パラメーターに 0 を指定することで、以前に登録されたコールバックの登録を解除できます。

詳細については、バグ チェック コールバックのビデオ ポート ドライバーのサポートを参照してください。

必要条件

要件 価値
サポートされる最小クライアント Windows XP SP1 以降のバージョンの Windows オペレーティング システムで使用できます。
ターゲット プラットフォーム の デスクトップ
ヘッダー video.h (Video.h を含む)
ライブラリ Videoprt.lib
DLL Videoprt.sys
IRQL PASSIVE_LEVEL

関連項目

HwVidBugcheckCallback の