IDebugControl3：：WaitForEvent 方法 (dbgeng.h)

WaitForEvent 方法等待中断到调试器引擎应用程序的事件。

语法

HRESULT WaitForEvent(
  [in] ULONG Flags,
  [in] ULONG Timeout
);

[in] Flags

设置为零。目前，此参数中没有可以使用的标志。

[in] Timeout

指定此方法返回之前要等待的毫秒数。如果 Timeout 为 INFINITE，则在发生中断调试器引擎应用程序的事件或发出退出中断之前，此方法不会返回。如果当前会话具有实时内核目标，则必须将 Timeout 设置为 INFINITE。

此方法可能会返回其他错误值，上述错误值可能具有其他含义。有关更多详细信息，请参阅返回值。

只能从启动调试器会话的线程调用方法。

发生事件时，调试器引擎将处理事件并调用事件回调。如果其中一个回调指示事件应通过返回DEBUG_STATUS_BREAK) (进入调试器引擎应用程序，则此方法将返回：否则，它会继续等待事件。事件筛选器还可以指定事件应进入调试器引擎应用程序。有关事件筛选器的详细信息，请参阅控制异常和事件。

此方法不是可重入的。调用它后，在返回之前，不能在任何客户端上再次调用它。具体而言，它不能从事件回调调用，包括由回调执行的扩展和命令。

如果任何目标都无法生成事件（例如，所有目标都已退出），则此方法将结束当前会话，放弃目标，然后返回E_UNEXPECTED。

常量 INFINITE 在 Winbase.h 中定义。

有关使用 WaitForEvent 控制调试器应用程序和目标的执行流的详细信息，请参阅调试会话和执行模型。有关事件回调的详细信息，请参阅监视事件。

要求	值
目标平台	桌面
标头	dbgeng.h (包括 Dbgeng.h、Winbase.h)