The StartInput callback method is called by the engine to indicate that it is waiting for a line of input.
HRESULT StartInput( ULONG BufferSize );
Specifies the number of characters requested. Any input longer than this size will be truncated.
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.
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.
|Header||dbgeng.h (include Dbgeng.h)|