Required port supplier interfaces

Applies to: Visual Studio Visual Studio for Mac

Note

This article applies to Visual Studio 2017. If you're looking for the latest Visual Studio documentation, see Visual Studio documentation. We recommend upgrading to the latest version of Visual Studio. Download it here

A port supplier must implement the IDebugPortSupplier2 interface.IDebugPortSupplier2

A port supplier supplies ports and implements them. Therefore, it must run the following interfaces:

• IDebugPort2

  Describes the port and enumerates all processes running on the port.

• IDebugPortEx2

  Provides for launching and terminating processes on the port.

• IDebugPortNotify2

  Provides a mechanism for programs running within this port's context to notify it of program node creation and destruction. For more information, see Program nodes.

• IConnectionPointContainer

  Provides a connection point for IDebugPortEvents2.

Port supplier operation

The IDebugPortEvents2 sink receives notifications when process and programs are created and destroyed on a port. A port is required to send IDebugProcessCreateEvent2 when a process is created and IDebugProcessDestroyEvent2 when a process is destroyed on the port. A port is also required to send IDebugProgramCreateEvent2 when a program is created and IDebugProgramDestroyEvent2 when a program is destroyed in a process running on the port.

A port typically sends program create and destroy events in response to the AddProgramNode and RemoveProgramNode methods, respectively.

Because a port can launch and terminate both physical processes and logical programs, the following interfaces must also be implemented by the debug engine:

• IDebugProcess2

  Describes the physical process. At least the following methods must be implemented:

  • EnumPrograms

  • GetName

  • GetServer

  • GetPhysicalProcessId

  • GetProcessId

  • GetAttachedSessionName

• IDebugProcessEx2

  Provides a way for the SDM to attach and detach itself from a process.

• IDebugProgram2

  Describes the logical program. At least the following methods must be implemented:

  • GetName

  • GetProcess

  • GetProgramId

• IDebugProgramEx2

  Provides a way for the SDM to attach to this program.

See also

• Implementing a port supplier