Wait Debugging Functions

Microsoft DirectShow 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:

\HKEY_LOCAL_MACHINE\<DebugRoot>\<Module Name>\TIMEOUT

where <DebugRoot> is the registry path described in the topic Debug Output Functions.

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

Requirements

**  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.