Share via

IVsProfilerLauncher Interface

  • Reference

Definition

Namespace:
Microsoft.VisualStudio.Shell.Interop
Assembly:
Microsoft.VisualStudio.Shell.Interop.11.0.dll
Assembly:
Microsoft.VisualStudio.Interop.dll
Package:
Microsoft.VisualStudio.Interop v17.11.40262

Provides the project system with the capability to launch targets under profiling.

public interface class IVsProfilerLauncher
public interface class IVsProfilerLauncher
__interface IVsProfilerLauncher
[System.Runtime.InteropServices.Guid("D7DC8C01-AFFF-45FE-B338-426E8072F6B7")]
[System.Runtime.InteropServices.InterfaceType(System.Runtime.InteropServices.ComInterfaceType.InterfaceIsIUnknown)]
public interface IVsProfilerLauncher
[<System.Runtime.InteropServices.Guid("D7DC8C01-AFFF-45FE-B338-426E8072F6B7")>]
[<System.Runtime.InteropServices.InterfaceType(System.Runtime.InteropServices.ComInterfaceType.InterfaceIsIUnknown)>]
type IVsProfilerLauncher = interface
Public Interface IVsProfilerLauncher
Attributes
GuidAttribute InterfaceTypeAttribute

Remarks

Typical usage for a project that delegates to the profiler to do the launch (recommended scenario):

  1. Inside the project system’s implementation of the LaunchProfiler method of the IVsProfilableProjectCfg interface, create one or more IVsProfilerLaunchTargetInfos.

  2. Get the SVsProfilerLauncher service to get the launch manager service.

    Note

    If the profiler is not installed, this service will not be available.

  3. Call LaunchProfiler with the created targets. The profiler will do the launch.

There is also an “Attach” case, where the project system should:

  1. Inside the project’s implementation of the LaunchProfiler method of the IVsProfilableProjectCfg interface, create the attach targets.

  2. Get the SVsProfilerLauncher service to get the launch manager service.

  3. Call QueryProfilingEnvironment to determine which environment variables need to set by the project system.

  4. Launch targets (with the right profiling environment variables set).

  5. Call LaunchProfiler with the attach targets to notify the profiler about the targets that were launched.

Methods

LaunchProfiler(IEnumVsProfilerTargetInfos)

Launches the profiler targets. If the project system has already done the launch, this method notifies the profiler about the targets that were launched.
QueryProfilingEnvironment(Array)

Queries the profiler for the profiling environment variables.

Applies to