Microsoft® DirectShow™ provides facilities for debug output, with a wide variety of options for the debug output location. Possible output locations include using the normal debugger output (the default), recording to a file with a given name, or using the Win32® standard output handle (creating a console if this handle is not already open). Once the debug output location is specified, each of the following debug facilities uses the same location.
Debug Output |
Debug NOTE (Message) Macros |
Debug Logging by Module Level |
Object Register Debugging |
The debug output location is chosen (based on the registry) when DbgInitialise is called. DbgTerminate must be called when this process finishes using the debug output location. These macros are generally called automatically by other debug routines.
To specify the debug output location, set the LogToFile value in the registry (under the HKEY_LOCAL_MACHINE\SOFTWARE\Debug\GLOBAL key) to one of the following (case-insensitive) values.
LogToFile Value | Results |
"Console" | Use the Microsoft Win32 standard output handle if it exists. If no standard output handle exists, allocate a console and use it for output. |
"Deb", "Debug", or "Debugger" | Use the Win32 OutputDebugString function. |
Any nonempty string other than the preceding | Write to file of that name. |
An empty string (or the registry key does not exist) | Use the Win32 OutputDebugString function. |
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.