Dela via


IVsProfilerLauncher Interface

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

Namespace:  Microsoft.VisualStudio.Shell.Interop
Assembly:  Microsoft.VisualStudio.Shell.Interop.11.0 (in Microsoft.VisualStudio.Shell.Interop.11.0.dll)

Syntax

'Declaration
<GuidAttribute("D7DC8C01-AFFF-45FE-B338-426E8072F6B7")> _
<InterfaceTypeAttribute(ComInterfaceType.InterfaceIsIUnknown)> _
Public Interface IVsProfilerLauncher
[GuidAttribute("D7DC8C01-AFFF-45FE-B338-426E8072F6B7")]
[InterfaceTypeAttribute(ComInterfaceType.InterfaceIsIUnknown)]
public interface IVsProfilerLauncher
[GuidAttribute(L"D7DC8C01-AFFF-45FE-B338-426E8072F6B7")]
[InterfaceTypeAttribute(ComInterfaceType::InterfaceIsIUnknown)]
public interface class IVsProfilerLauncher
[<GuidAttribute("D7DC8C01-AFFF-45FE-B338-426E8072F6B7")>]
[<InterfaceTypeAttribute(ComInterfaceType.InterfaceIsIUnknown)>]
type IVsProfilerLauncher =  interface end
public interface IVsProfilerLauncher

The IVsProfilerLauncher type exposes the following members.

Methods

  Name Description
Public method LaunchProfiler Launches the profiler targets. If the project system has already done the launch, this method notifies the profiler about the targets that were launched.
Public method QueryProfilingEnvironment Queries the profiler for the profiling environment variables.

Top

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.

See Also

Reference

Microsoft.VisualStudio.Shell.Interop Namespace