IDebugClient::SetKernelConnectionOptions method

The SetKernelConnectionOptions method updates some of the connection options for a live kernel target.

Syntax


HRESULT SetKernelConnectionOptions(
  [in] PCSTR Options
);

Parameters

Options [in]

Specifies the connection options to update. The possible values are:

ValueDescription

"resync"

Re-synchronize the connection between the debugger engine and the kernel. For more information, see Synchronizing with the Target Computer.

"cycle_speed"

For kernel connections through a COM port, cycle through the supported baud rates; for other connections, do nothing. For more information, see CTRL+A (Toggle Baud Rate).

 

Return value

This method may also return error values. See Return Values for more details.

Return codeDescription
S_OK

The method was successful.

E_UNEXPECTED

The current target is not a live (non-local) kernel target.

 

Remarks

This method is available only for live kernel targets that are not local and not connected through eXDI. This method is reentrant.

For more information about connecting to live kernel-mode targets, see Live Kernel-Mode Targets.

Requirements

Target platform

Desktop

Header

Dbgeng.h (include Dbgeng.h)

See also

IDebugClient
IDebugClient2
IDebugClient3
IDebugClient4
IDebugClient5
AttachKernel

 

 

Send comments about this topic to Microsoft

Show: