Share via

WaitForDebugEvent (Windows Embedded CE 6.0)

1/6/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
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
Windows Embedded CE Windows CE 2.0 and later

See Also

Reference

Debugging Functions
ContinueDebugEvent
DebugActiveProcess
DebugBreak
OutputDebugString
DEBUG_EVENT

  • Last updated on