Microsoft DirectX 9.0

Wait Debugging Functions

Microsoft® DirectShow® provides several functions for debugging infinite waits.

In retail builds, the DbgWaitForMultipleObjects and DbgWaitForSingleObject functions work like their Microsoft® Win32® counterparts, WaitForMultipleObjects and WaitForSingleObject, with infinite time-out intervals.

In debug builds, these functions use a global time-out value. If the time-out expires, the function triggers an assert. The following registry key specifies the time-out value, in milliseconds:


If the key does not exist, the time-out value defaults to INFINITE. You can use the DbgSetWaitTimeout function to override the registry entry.


Header: Declared in Wxdebug.h; include Streams.h.

Library: Use Strmbase.lib (retail builds) or Strmbasd.lib (debug builds).

Function Description
DbgSetWaitTimeout Sets the debugging time-out value.
DbgWaitForMultipleObjects Waits for any (or all) of the specified objects to be signaled.
DbgWaitForSingleObject Waits for an object to become signaled.