WaitForDebugEvent

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

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: Value Result 0 Tests for a debugging event and returns immediately. INFINITE Returns after a debugging event has occurred. Other Returns 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
Windows Embedded CE	Windows CE 2.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

ContinueDebugEvent
DebugActiveProcess
DebugBreak
OutputDebugString
DEBUG_EVENT