DkmRuntimeHardwareDataBreakpoint.Create(DkmRuntimeInstance, Guid, DkmThread, UInt64, DkmDataAccessStopMask, Int32, DkmDataItem) Methode

Definition

Erstellt ein neues dkmruntimehardwaredatabreakpoint-Objekt. Nach der Erstellung befindet sich der Breakpoint im deaktivierten Zustand und muss explizit aktiviert werden. Der Aufrufer ist dafür verantwortlich, das erstellte Objekt zu schließen, nachdem es abgeschlossen wurde.

public:
 static Microsoft::VisualStudio::Debugger::Breakpoints::DkmRuntimeHardwareDataBreakpoint ^ Create(Microsoft::VisualStudio::Debugger::DkmRuntimeInstance ^ RuntimeInstance, Guid SourceId, Microsoft::VisualStudio::Debugger::DkmThread ^ Thread, System::UInt64 Address, Microsoft::VisualStudio::Debugger::Breakpoints::DkmDataAccessStopMask Access, int Size, Microsoft::VisualStudio::Debugger::DkmDataItem ^ DataItem);
public static Microsoft.VisualStudio.Debugger.Breakpoints.DkmRuntimeHardwareDataBreakpoint Create (Microsoft.VisualStudio.Debugger.DkmRuntimeInstance RuntimeInstance, Guid SourceId, Microsoft.VisualStudio.Debugger.DkmThread Thread, ulong Address, Microsoft.VisualStudio.Debugger.Breakpoints.DkmDataAccessStopMask Access, int Size, Microsoft.VisualStudio.Debugger.DkmDataItem DataItem);
static member Create : Microsoft.VisualStudio.Debugger.DkmRuntimeInstance * Guid * Microsoft.VisualStudio.Debugger.DkmThread * uint64 * Microsoft.VisualStudio.Debugger.Breakpoints.DkmDataAccessStopMask * int * Microsoft.VisualStudio.Debugger.DkmDataItem -> Microsoft.VisualStudio.Debugger.Breakpoints.DkmRuntimeHardwareDataBreakpoint
Public Shared Function Create (RuntimeInstance As DkmRuntimeInstance, SourceId As Guid, Thread As DkmThread, Address As ULong, Access As DkmDataAccessStopMask, Size As Integer, DataItem As DkmDataItem) As DkmRuntimeHardwareDataBreakpoint

Parameter

RuntimeInstance
DkmRuntimeInstance

In Die dkmruntimeinstance-Klasse stellt eine Ausführungsumgebung dar, die in einen dkmprocess geladen wird und den zu debuggenden Code enthält.

SourceId
Guid

In Identifiziert die Quelle eines Objekts. Sourceids werden verwendet, um das Filtern in Szenarios zu ermöglichen, wenn mehrere Komponenten möglicherweise Instanzen einer Klasse erstellen. Quell-IDs können z. b. verwendet werden, um zu bestimmen, ob ein Breakpoint von der AD7 Al (z. b. Benutzer-Haltepunkt) oder anderen Haltepunkten, die auf SDM-Ebene sichtbar sind, anstelle eines halte Punkts, der von einer anderen Komponente (z. b. einem internen Breakpoint für die schrittweise), erstellt wird.

Thread
DkmThread

[In, optional] Der Thread, in dem dieser Breakpoint ausgelöst werden soll. Wenn der Wert NULL ist, wird der Breakpoint für alle Threads ausgelöst.

Address
UInt64

In Die Adresse, an der beendet werden soll Diese Adresse muss entsprechend dem Größen Parameter angepasst werden (Beispiel: Wenn die Größe 4 beträgt, muss die Adresse ein Vielfaches von 4 sein).

Access
DkmDataAccessStopMask

In Maske der Gründe, warum der Daten Haltepunkt ausgelöst werden soll. Wenn z. b. "Write" festgelegt ist, wird der Breakpoint ausgelöst, wenn die Speicheradresse geschrieben wird.

Size
Int32

In Gibt die Größe des Speicher Orts in Bytes an, der für den Zugriff überwacht werden soll. Bei einem x86-basierten Prozessor kann dieser Parameter 1, 2 oder 4 sein. Wenn der Zugriff jedoch DkmDataAccessStopMask.Exeniedlich ist, muss die Größe 1 lauten. Bei einem x64-basierten Prozessor kann dieser Parameter 1, 2, 4 oder 8 sein. Wenn der Zugriff auf den Zugriff auf den Zugriff jedoch DkmDataAccessStopMask.Exeniedlich ist, muss die Größe 1 lauten. Bei einem Itanium-basierten Prozessor kann dieser Parameter eine beliebige Potenz von 2 sein, von 1 bis 0x80000000.

DataItem
DkmDataItem

[In, optional] Das Datenobjekt, das der neuen dkmruntimehardwaredatabreakpoint-Instanz hinzugefügt werden soll. Übergeben Sie "Null", wenn der Aufrufer kein Datenelement hinzufügen muss.

Gibt zurück

DkmRuntimeHardwareDataBreakpoint

Vorgenommen Ergebnis dieses Methoden Aufrufes.

Gilt für