Metodo IDebugInputCallbacks::StartInput (dbgeng.h)

Il metodo di callback StartInput viene chiamato dal motore per indicare che è in attesa di una riga di input.

Sintassi

HRESULT StartInput(
  [in] ULONG BufferSize
);

Parametri

[in] BufferSize

Specifica il numero di caratteri richiesti. Qualsiasi input più lungo di questa dimensione verrà troncato.

Valore restituito

Il valore restituito viene ignorato dal motore a meno che non indichi un errore di chiamata di procedura remota; in questo caso il client, con cui viene registrato l'oggetto IDebugEventCallbacks , è disabilitato.

Commenti

Questo metodo indica che il motore è in attesa di una riga di input da qualsiasi client. Ciò può verificarsi se, ad esempio, il metodo Input è stato chiamato su un client.

Dopo aver chiamato questo metodo, il motore attende fino a quando non riceve un input. Quando riceve l'input, chiama IDebugInputCallbacks::EndInput per informare tutti gli oggetti IDebugInputCallbacks registrati con i client che non sono più in attesa di input.

L'oggetto IDebugInputCallbacks può fornire al motore una riga di input chiamando i metodi ReturnInput o ReturnInputWide .

Per altre informazioni sull'input del motore di debugger, vedere Input e output.

Requisiti