次の方法で共有

WdfVerifierDbgBreakPoint 関数 (wdfverifier.h)

  • [アーティクル]

[KMDF と UMDF に適用]

WdfVerifierDbgBreakPoint 関数は、デバッガーが実行されている場合にカーネル デバッガーに分割されます。

構文

void WdfVerifierDbgBreakPoint();

戻り値

何一つ

備考

WdfVerifierDbgBreakPoint 関数は、次のいずれかが当てはまる場合にカーネル デバッガーに分割されます。

  • DbgBreakOnError は、レジストリで 0 以外の値に設定されます。
  • VerifierOn が 0 以外の値に設定され、DbgBreakOnError が設定されていません。
  • ドライバー検証ツールが有効になっており、ドライバーはフレームワーク バージョン 1.9 以降でビルドされており、VerifierOn も DbgBreakOnError も設定されていません。
ドライバーのデバッグに使用できるレジストリ エントリの詳細については、「Framework-Based ドライバー をデバッグするためのレジストリ エントリをする」を参照してください。

ドライバーのデバッグの詳細については、「KMDF ドライバーのデバッグ」を参照してください。

例

次のコード例は、ドライバーが I/O 要求の出力バッファーを取得するエラーを処理する方法を示しています。

Status = WdfRequestRetrieveOutputMemory(
                                        Request,
                                        &memory
                                        );
if( !NT_SUCCESS(Status) ) {
    KdPrint(("EvtIoRead could not get request memory buffer. Status: 0x%x\n",Status));
    WdfVerifierDbgBreakPoint();
    WdfRequestCompleteWithInformation(
                                      Request,
                                      Status,
                                      0L
                                      );
    return;
}

必要条件

要件 価値
ターゲット プラットフォーム の 万国
最小 KMDF バージョン 1.0
UMDF の最小バージョン を する 2.0
ヘッダー wdfverifier.h (Wdf.h を含む)
ライブラリ Wdf01000.sys (KMDF);WUDFx02000.dll (UMDF)
IRQL 任意のレベル
DDI コンプライアンス規則 を する DriverCreate(kmdf)

関連項目

WdfVerifierKeBugCheck