Debugging Tools for Windows

IDebugInputCallbacks::StartInput

The StartInput callback method is called by the engine to indicate that it is waiting for a line of input.

HRESULT
  IDebugInputCallbacks::StartInput(
    IN ULONG  BufferSize
    );

Parameters

BufferSize
Specifies the number of characters requested. Any input longer than this size will be truncated.

Return Value

The return value is ignored by the engine unless it indicates a remote procedure call error; in this case the client, with which this IDebugEventCallbacks object is registered, is disabled.

Comments

This method indicates that the engine is waiting for a line of input from any client. This can occur if, for example, the Input method was called on a client.

After calling this method, the engine waits until it receives some input. When it does receive input, it calls IDebugInputCallbacks::EndInput to inform all the IDebugInputCallbacks objects that are registered with clients that it is no longer waiting for input.

The IDebugInputCallbacks object can provide the engine with a line of input by calling either the ReturnInput or ReturnInputWide methods.

For more information about debugger engine input, see Input and Output.

Requirements

Headers: Defined in dbgeng.h. Include dbgeng.h.

Build machine: CAPEBUILD