Using Clients and the Engine

A DbgEng extension interacts with the debugger engine through a client object.

When an extension function is called, it is passed a client. The extension function should use this client for all its interaction with the debugger engine, unless it has a specific reason to use another client.

An extension library may create its own client object upon initialization by using DebugCreate. This client can be used to register callback objects from the DLL.

Note Care should be taken when modifying the client passed to an extension function. In particular, registering callbacks with this client could disrupt the input, output, or event handling of the debugger. It is recommended that a new client be created to register callbacks.

Send comments about this topic to Microsoft