WaitForDebugEvent (Compact 2013)

  • Article

3/28/2014

This function blocks the debugger thread until a debug event is generated in the target process being debugged or the specified timeout elapses.

Syntax

BOOL WaitForDebugEvent(
  LPDEBUG_EVENT lpDebugEvent, 
  DWORD dwMilliseconds 
);

Parameters

Parameter

Description

lpDebugEvent

[in] Pointer to a DEBUG_EVENT structure that is filled with information about the debugging event.

dwMilliseconds

[in] Number of milliseconds to wait for a debugging event. The following table shows expected return values:

ValueResult
0Tests for a debugging event and returns immediately.
INFINITEReturns after a debugging event has occurred.
OtherReturns 0. GetLastError indicates WAIT_TIMEOUT.

Return Value

Nonzero indicates success.

Zero indicates failure.

To get extended error information, call GetLastError.

Remarks

Only the thread that created the process being debugged can call WaitForDebugEvent.

There is a 64 (MAXIMUM_WAIT_OBJECTS) thread limit for WaitForDebugEvent, which means that the maximum threads that can be debugged per-process is 64.

This call translates to the read API call of the debug message queue with the specified timeout value.

Requirements

Header

winbase.h

Library

coredll.lib,
Nk.lib

See Also

Reference

Debugging Functions
ContinueDebugEvent
DebugActiveProcess
DebugBreak
OutputDebugString
DEBUG_EVENT