生成基本的 v4 打印机驱动程序-Exception.cpp

15 Sep, 2025

• Exception.cpp

//
// File Name:
//
//    Exception.cpp
//
// Abstract:
//
//    Exception routine definitions.
//

#include "precomp.h"
#include "WppTrace.h"
#include "CustomWppCommands.h"
#include "Exception.h"
#include "filtertypes.h"

#include "Exception.tmh"

namespace MyV4PrintDriver_Render_Filter
{

void ThrowHRException(
    HRESULT hr,
    char const *fileName,
    int lineNum
    )
{
    DoTraceMessage(
        RENDERFILTER_TRACE_ERROR,
        L"Throwing HRESULT Exception from %s:%d (HRESULT=%!HRESULT!)", 
        fileName, 
        lineNum, 
        hr
        );

    throw hr_error(hr);
}

} // namespace MyV4PrintDriver_Render_Filter

文件概述

• 功能：提供一个异常处理函数 ThrowHRException ，用于在发生错误时抛出带有HRESULT错误码的异常，并记录日志。
• 主要内容：
  定义了一个抛出HRESULT异常的函数，结合WPP（Windows软件跟踪预处理器）进行错误日志记录。
  使用命名空间 ThrowHRException 组织代码。

代码结构与功能详解

1. 头文件与预处理器

• 作用：
  包含必要的头文件，提供预编译宏、WPP 跟踪支持、自定义 WPP 命令、异常处理定义（Exception.h）和过滤器类型定义（filtertypes.h）。
  Exception.tmh 是 WPP 跟踪生成的头文件，用于日志记录。

2. 命名空间 namespace MyV4PrintDriver_Render_Filter

• 作用: 使用命名空间 MyV4PrintDriver_Render_Filter 避免符号冲突，组织与此渲染过滤器相关的代码。

3. 函数ThrowHRException

void ThrowHRException(
    HRESULT hr,
    char const *fileName,
    int lineNum
    )
{
    DoTraceMessage(
        RENDERFILTER_TRACE_ERROR,
        L"Throwing HRESULT Exception from %s:%d (HRESULT=%!HRESULT!)", 
        fileName, 
        lineNum, 
        hr
        );

    throw hr_error(hr);
}

• 功能: 抛出带有 HRESULT 错误码的异常，并在抛出前记录错误日志。
• 参数:
  hr: HRESULT 错误码，表示发生的错误类型（如 E_OUTOFMEMORY、E_POINTER 等）。 fileName: 发生错误的源文件名（通常由 __FILE__ 宏提供）。 lineNum: 发生错误的代码行号（通常由 __LINE__ 宏提供）。
• 逻辑:
  1.使用 DoTraceMessage 记录错误日志，日志级别为 RENDERFILTER_TRACE_ERROR。
  日志内容包括文件名、行号和 HRESULT 错误码，格式为：Throwing HRESULT Exception from <fileName>:<lineNum> (HRESULT=<hr>)
L 前缀表示宽字符（Unicode）字符串，%!HRESULT! 是 WPP 的格式化占位符，用于将 HRESULT 值转换为可读字符串。
  2.抛出hr_error异常，携带hr错误码。
• 异常类型:
  hr_error 是一个自定义异常类（定义在 Exception.h 中），用于封装 HRESULT 错误码。 抛出异常后，调用者需要通过 try-catch 块捕获并处理该异常。

代码总结

1. 主要功能:

• 定义了一个异常处理函数 ThrowHRException，用于在渲染过滤器中发生错误时抛出 HRESULT 异常。
• 结合 WPP 跟踪记录详细的错误信息（包括文件名、行号和错误码），便于调试。

2. 关键点:

• 使用 WPP 日志（DoTraceMessage）记录错误，便于在开发和维护过程中定位问题。
• 异常机制基于 hr_error 类，允许调用者捕获并处理 HRESULT 错误。
• 函数设计简洁，主要用于标准化错误处理流程。

3. 应用场景:

• 该函数通常在渲染过滤器的其他模块中调用，用于处理 COM 接口或其他操作中的错误。
• 例如，在 dllentry.cpp 中，CATCH_VARIOUS 宏可能会捕获 hr_error 异常并转换为 HRESULT 返回值。

4. WPP 跟踪:

• WPP（Windows Software Trace Preprocessor）是一种高效的日志记录机制，广泛用于 Windows 驱动程序开发。
• RENDERFILTER_TRACE_ERROR 是自定义的日志级别，表示错误级别的跟踪信息。

原始资料地址：
生成基本的 v4 打印机驱动程序
如有侵权联系删除 仅供学习交流使用