DkmGPUComputeThread.Create Method

Definition

Namespace:

Microsoft.VisualStudio.Debugger.GPU

Assembly:

Microsoft.VisualStudio.Debugger.Engine.dll

Package:

Microsoft.VisualStudio.Debugger.Engine v17.8.1101801

Overloads

Create(DkmProcess, UInt64, Boolean, Int64, DkmGPUComputeKernel, DkmThread+System, DkmDataItem)	Create a new DkmGPUComputeThread object instance. Location constraint: API must be called from a Monitor component (component level < 100,000).
Create(DkmProcess, UInt64, Boolean, Int64, DkmGPUComputeKernel, DkmThread, DkmThread+System, DkmDataItem)	Create a new DkmGPUComputeThread object instance. Location constraint: API must be called from a Monitor component (component level < 100,000). This API was introduced in Visual Studio 12 RTM (DkmApiVersion.VS12RTM).

Create(DkmProcess, UInt64, Boolean, Int64, DkmGPUComputeKernel, DkmThread+System, DkmDataItem)

Create a new DkmGPUComputeThread object instance.

Location constraint: API must be called from a Monitor component (component level < 100,000).

public:
 static Microsoft::VisualStudio::Debugger::GPU::DkmGPUComputeThread ^ Create(Microsoft::VisualStudio::Debugger::DkmProcess ^ Process, System::UInt64 NativeStartAddress, bool IsMainThread, long GlobalThreadIndex, Microsoft::VisualStudio::Debugger::GPU::DkmGPUComputeKernel ^ ComputeKernel, Microsoft::VisualStudio::Debugger::DkmThread::System ^ System, Microsoft::VisualStudio::Debugger::DkmDataItem ^ DataItem);

public static Microsoft.VisualStudio.Debugger.GPU.DkmGPUComputeThread Create (Microsoft.VisualStudio.Debugger.DkmProcess Process, ulong NativeStartAddress, bool IsMainThread, long GlobalThreadIndex, Microsoft.VisualStudio.Debugger.GPU.DkmGPUComputeKernel ComputeKernel, Microsoft.VisualStudio.Debugger.DkmThread.System? System, Microsoft.VisualStudio.Debugger.DkmDataItem? DataItem);

static member Create : Microsoft.VisualStudio.Debugger.DkmProcess * uint64 * bool * int64 * Microsoft.VisualStudio.Debugger.GPU.DkmGPUComputeKernel * Microsoft.VisualStudio.Debugger.DkmThread.System * Microsoft.VisualStudio.Debugger.DkmDataItem -> Microsoft.VisualStudio.Debugger.GPU.DkmGPUComputeThread

Public Shared Function Create (Process As DkmProcess, NativeStartAddress As ULong, IsMainThread As Boolean, GlobalThreadIndex As Long, ComputeKernel As DkmGPUComputeKernel, System As DkmThread.System, DataItem As DkmDataItem) As DkmGPUComputeThread

Parameters

Process

DkmProcess

[In] DkmProcess represents a target process which is being debugged. The debugger debugs processes, so this is the basic unit of debugging. A DkmProcess can represent a system process or a virtual process such as minidumps.

NativeStartAddress

UInt64

[In] If available, this is the Win32 start address of this thread (value passed to the CreateThread API). The value will not always be available, for example, it is generally not available in scenarios where the thread was started after the debugger attached, or in minidumps.

IsMainThread

Boolean

[In] True if this is the main thread of this process. The main thread is the first thread to start.

GlobalThreadIndex

Int64

[In] Unique to kernel compute thread index.

ComputeKernel

DkmGPUComputeKernel

[In] DkmGPUComputeKernel represents a GPU compute kernel running in the target process.

System

DkmThread.System

[In,Optional] Describes traits of the thread which are relevant to a full Win32 thread. Currently, this value is required, and all threads will have a 'System' block. In the future, this value may be NULL if the DkmThread represents something other than a full Win32 thread.

DataItem

DkmDataItem

[In,Optional] Data object to add to the new DkmGPUComputeThread instance. Pass 'null' in the case that the caller doesn't need to add a data item.

Returns

DkmGPUComputeThread

[Out] Result of this method call.

Create(DkmProcess, UInt64, Boolean, Int64, DkmGPUComputeKernel, DkmThread, DkmThread+System, DkmDataItem)

Create a new DkmGPUComputeThread object instance.

Location constraint: API must be called from a Monitor component (component level < 100,000).

This API was introduced in Visual Studio 12 RTM (DkmApiVersion.VS12RTM).

public:
 static Microsoft::VisualStudio::Debugger::GPU::DkmGPUComputeThread ^ Create(Microsoft::VisualStudio::Debugger::DkmProcess ^ Process, System::UInt64 NativeStartAddress, bool IsMainThread, long GlobalThreadIndex, Microsoft::VisualStudio::Debugger::GPU::DkmGPUComputeKernel ^ ComputeKernel, Microsoft::VisualStudio::Debugger::DkmThread ^ NativeThread, Microsoft::VisualStudio::Debugger::DkmThread::System ^ System, Microsoft::VisualStudio::Debugger::DkmDataItem ^ DataItem);

public static Microsoft.VisualStudio.Debugger.GPU.DkmGPUComputeThread Create (Microsoft.VisualStudio.Debugger.DkmProcess Process, ulong NativeStartAddress, bool IsMainThread, long GlobalThreadIndex, Microsoft.VisualStudio.Debugger.GPU.DkmGPUComputeKernel ComputeKernel, Microsoft.VisualStudio.Debugger.DkmThread? NativeThread, Microsoft.VisualStudio.Debugger.DkmThread.System? System, Microsoft.VisualStudio.Debugger.DkmDataItem? DataItem);

static member Create : Microsoft.VisualStudio.Debugger.DkmProcess * uint64 * bool * int64 * Microsoft.VisualStudio.Debugger.GPU.DkmGPUComputeKernel * Microsoft.VisualStudio.Debugger.DkmThread * Microsoft.VisualStudio.Debugger.DkmThread.System * Microsoft.VisualStudio.Debugger.DkmDataItem -> Microsoft.VisualStudio.Debugger.GPU.DkmGPUComputeThread

Public Shared Function Create (Process As DkmProcess, NativeStartAddress As ULong, IsMainThread As Boolean, GlobalThreadIndex As Long, ComputeKernel As DkmGPUComputeKernel, NativeThread As DkmThread, System As DkmThread.System, DataItem As DkmDataItem) As DkmGPUComputeThread

Parameters

Process

DkmProcess

[In] DkmProcess represents a target process which is being debugged. The debugger debugs processes, so this is the basic unit of debugging. A DkmProcess can represent a system process or a virtual process such as minidumps.

NativeStartAddress

UInt64

[In] If available, this is the Win32 start address of this thread (value passed to the CreateThread API). The value will not always be available, for example, it is generally not available in scenarios where the thread was started after the debugger attached, or in minidumps.

IsMainThread

Boolean

[In] True if this is the main thread of this process. The main thread is the first thread to start.

GlobalThreadIndex

Int64

[In] Unique to kernel compute thread index.

ComputeKernel

DkmGPUComputeKernel

[In] DkmGPUComputeKernel represents a GPU compute kernel running in the target process.

NativeThread

DkmThread

[In,Optional] The native thread on which an exception is raised to notify the debugger that a GPU debug event is available.

System

DkmThread.System

[In,Optional] Describes traits of the thread which are relevant to a full Win32 thread. Currently, this value is required, and all threads will have a 'System' block. In the future, this value may be NULL if the DkmThread represents something other than a full Win32 thread.

DataItem

DkmDataItem

[In,Optional] Data object to add to the new DkmGPUComputeThread instance. Pass 'null' in the case that the caller doesn't need to add a data item.

Returns

DkmGPUComputeThread

[Out] Result of this method call.