OutputDebugString()

求助编辑百科名片

<windows.h> 文件声明了 OutputDebugString() 函数的两个版本 - 一个用于 ASCII，一个用于 Unicode - 不像绝大多数 Win32 API 一样，原始版本是 ASCII。而大多数的 Win32 API 的原始版本是 Unicode。使用一个 NULL 结尾的字符串缓冲区简单调用 OutputDebugString() 将导致信息出现在调试器中，如果有调试器的话。

目录

OutputDebugString ()

1. 应用程序用法
2. 协议

展开

OutputDebugString ()

1. 应用程序用法
2. 协议

展开

编辑本段OutputDebugString ()

　　坚定的 Win32 开发人员可能对 OutputDebugString() API 函数比较熟悉，它可以使你的程序和 调试器进行交谈。它要比创建日志文件容易，而且所有“真正的”调试器都能使用它。应用程序和调试器交谈的机制相当简单，而本文将揭示整件事情是如何工作的。

　　本文首先是由以下事件促使的，我们观察到 OutputDebugString() 在 管理员和非管理员用户试图一起工作或游戏时并不总是能可靠地工作（至少在 Win2000 上）。我们怀疑是一些相关的 内核对象的权限问题，此间涉略了相当多不得不写下来的信息。

　　请注意，尽管我们使用了“调试器”这一术语，但不是从调试 API 的意义上来使用的：并没有“单步执行”、“ 断点”或者“附着到进程”等可以在 MS Visual C 或者一些真正的交互 开发环境中找到的东西。从某种意义上来说，任何实现了 协议的程序都是“调试器”。可能是一个非常小的命令行工具，或者像来自于 SysInternals 那帮聪明的家伙们的 DebugView 那样的高级货。

应用程序用法

　　构建一条信息并发送之的通常用法是：

　　sprintf(msgbuf, "Cannot open file %s [err=%ld]\n", fname, GetLastError());OutputDebugString(msgbuf);不过在实际环境中我们中的不少人会创建一个前端函数，以允许我们使用 printf 风格的格式化。下面的 odprintf() 函数格式化字符串，确保结尾有一个合适的回车换行（删除原来的行结尾），并且发送信息到调试器。

　　#include <stdio.h>#include <stdarg.h>#include <ctype.h>void __cdecl odprintf(const char *format, ...){char buf[4096], *p = buf;va_list args;va_start(args, format);p += _vsnprintf(p, sizeof buf - 1, format, args);va_end(args);while ( p > buf && isspace(p[-1]) )*--p = '\0';*p++ = '\r';*p++ = '\n';*p = '\0';OutputDebugString(buf);}于是在代码中使用它就很简单：

　　...odprintf("Cannot open file %s [err=%ld]", fname, GetLastError());...我们已经这样使用多年了。

协议

　　在应用程序和调试器之间传递数据是通过一个 4KB 大小的共享内存块完成的，并有一个 互斥量和两个 事件对象用来保护对他的访问。下面就是相关的四个 内核对象：

　　对象名称对象类型DBWinMutexMutexDBWIN_BUFFERSection （ 共享内存）DBWIN_BUFFER_READYEventDBWIN_DATA_READYEvent互斥量通常一直保留在系统中，其他三个对象仅当调试器要接收信息才出现。事实上 - 如果一个调试器发现后三个对象已经存在，它会拒绝运行。

　　当 DBWIN_BUFFER 出现时，会被组织成以下结构。进程 ID 显示信息的来源，字符串数据填充这 4K 的剩余部分。按照约定，信息的末尾 总是包括一个 NULL 字节。

　　struct dbwin_buffer { DWORD dwProcessId; char data[4096-sizeof(DWORD)]; }; 当 OutputDebugString() 被应用调用时，它执行以下步骤。注意在任意位置的错误都将放弃整个事情，调试请求被认为是什么也不做（不会发送字符串）。

　　打开 DBWinMutex 并且等待，直到我们取得了独占访问。映射 DBWIN_BUFFER 段到内存中：如果没有发现，则没有调试器在运行，将忽略整个请求。打开 DBWIN_BUFFER_READY 和 DBWIN_DATA_READY 事件对象。就像共享内存段一样，缺少对象意味着没有可用的调试器。等待 DBWIN_BUFFER_READY 事件对象为有信号状态：表示内存缓冲区不再被占用。大部分时候，这一事件对象一被检查就处于有信号状态，但等待缓冲区就绪不会超过 10 秒（超时将放弃请求）。复制数据直到内存缓冲区中接近 4KB，再保存当前进程 ID。总是放置一个 NULL 字节到字符串结尾。通过设置 DBWIN_DATA_READY 事件对象告诉调试器缓冲区就绪。调试器从那儿取走它。释放互斥量。关闭事件对象和段对象，但保留互斥量的句柄以备后用。在 调试器端会简单一点。互斥量根本不需要，如果事件对象和/或共享内存对象已经存在，则假定其他调试器已经在运行。系统中任意时刻只能存在一个调试器。

　　创建共享内存段以及两个事件对象。如果失败，退出。设置 DBWIN_BUFFER_READY 事件对象，由此应用程序得知缓冲区可用。等待 DBWIN_DATA_READY 事件对象变为有信号状态。从内存缓冲区中提取进程 ID 和 NULL 结尾的字符串。转到步骤 2。这使我们认为这决不是一种低消耗的发送信息的方法，应用程序的运行速度会受到调试器的左右。