Share via

vDbgPrintEx 函数 (wdm.h)

  • 项目

如果满足某些条件， vDbgPrintEx 例程会将字符串发送到内核调试器。

语法

NTSYSAPI ULONG vDbgPrintEx(
  [in] ULONG   ComponentId,
  [in] ULONG   Level,
  [in] PCCH    Format,
  [in] va_list arglist
);

参数

[in] ComponentId

调用此例程的组件。 此参数必须是 Dpfilter.h 中定义的组件名称筛选器 ID 之一。 若要避免将驱动程序的输出与 Windows 组件的输出混合，应仅对 ComponentId 使用以下值：

  • DPFLTR_IHVVIDEO_ID
  • DPFLTR_IHVAUDIO_ID
  • DPFLTR_IHVNETWORK_ID
  • DPFLTR_IHVSTREAMING_ID
  • DPFLTR_IHVBUS_ID
  • DPFLTR_IHVDRIVER_ID

[in] Level

正在发送的消息的严重性。 此参数可以是任何 32 位整数。 介于 0 和 31 之间的值 (非独占) 与 32 到 0xFFFFFFFF 之间的值不同。 有关如何处理值的详细信息，请参阅 读取和筛选调试消息。

[in] Format

指向要打印的格式字符串的指针。 Format 字符串支持大多数 printf 样式的格式设置代码。 但是，只能在 IRQL = PASSIVE_LEVEL 的情况下使用 Unicode 格式代码 (%C、 %S、 %lc、 %ls、 %wc、 %ws 和 %w) Z 。 vDbgPrintEx 例程不支持 (%f、%e、%E、%g、%G、%a 或 %A) 的任何浮点类型。

[in] arglist

格式字符串的参数列表。 vDbgPrintEx 例程使用此列表的方式与 vprintf 相同。

返回值

如果操作成功，vDbgPrintEx 将返回STATUS_SUCCESS。 否则，此例程将返回相应的错误代码。

注解

只有内核模式驱动程序可以调用 vDbgPrintEx 例程。

可以在 IRQL = DIRQL <中调用 vDbgPrintEx。 但是，只能在 IRQL = PASSIVE_LEVEL 使用 Unicode 格式代码 (%wc 和 %ws) 。 此外，由于调试器使用进程间中断 (IPI) 与其他处理器通信，因此在 IRQL > DIRQL 中调用 vDbgPrintEx 可能会导致死锁。

vDbgPrintEx 要么将创建的字符串传递给内核调试器，要么不执行任何操作，具体取决于 ComponentId、 Level 和相应的组件筛选器掩码的值。 有关 vDbgPrintEx 的作用的详细信息，请参阅 读取和筛选调试消息。

除非绝对必要，否则不应从用户输入或其他进程获取字符串并将其传递给 vDbgPrintEx。 如果确实使用了未创建的字符串，则必须验证此字符串是有效的格式字符串，并且格式代码与类型和数量的参数列表匹配。 最佳编码做法是，所有 格式 字符串都是静态的，并在编译时定义。

格式字符串的大小或参数列表中的参数数没有上限。 但是，对 vDbgPrintEx 的任何一次调用将仅传输 512 字节的信息。

调试器使用的缓冲区的大小也有限制。 有关此限制的详细信息，请参阅 DbgPrint 缓冲区和调试器。

此例程在 Wdm.h 中定义。 组件筛选器 ID 在 Dpfilter.h 中定义。

要求

要求 值
最低受支持的客户端 在 Microsoft Windows XP 和更高操作系统版本中可用。
目标平台 通用
标头 wdm.h (包括 Dpfilter.h、Wdm.h、Ntddk.h、Ndis.h)
Library NtDll.lib (用户模式) ;NtosKrnl.lib (内核模式)
DLL NtDll.dll (用户模式) ;NtosKrnl.exe (内核模式)
IRQL <= DIRQL (请参阅注释部分)

另请参阅

DbgPrintEx