DkmRuntimeHardwareDataBreakpoint.Create(DkmRuntimeInstance, Guid, DkmThread, UInt64, DkmDataAccessStopMask, Int32, DkmDataItem) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Создает новый объект Дкмрунтимехардваредатабреакпоинт. После создания точка останова находится в отключенном состоянии и должна быть явно включена. Вызывающий объект отвечает за закрытие созданного объекта после его завершения.
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
Параметры
- RuntimeInstance
- DkmRuntimeInstance
Окне Класс Дкмрунтимеинстанце представляет среду выполнения, которая загружается в Дкмпроцесс и содержит код для отладки.
- SourceId
- Guid
Окне Определяет источник объекта. Саурцеидс используются для включения фильтрации в сценариях, когда несколько компонентов могут создавать экземпляры класса. Например, идентификаторы источников можно использовать, чтобы определить, поступает ли точка останова из AD7 AL (например, точки останова пользователя или другой точки останова, видимой на уровне SDM) вместо точки останова, которая может быть создана другим компонентом (например, внутренняя точка останова, используемая для пошагового выполнения).
- Thread
- DkmThread
[Входные, необязательные] Поток, в котором должна срабатывать эта точка останова. Если значение равно null, точка останова будет срабатывать во всех потоках.
- Address
- UInt64
Окне Адрес для завершения. Этот адрес должен быть соответствующим образом согласованным с параметром size (например, если размер равен 4, адрес должен быть кратным 4).
- Access
- DkmDataAccessStopMask
Окне Маска причин, по которым должна срабатывать точка останова в данных. Например, если задан параметр "Write", точка останова будет срабатывать при записи места в памяти.
- Size
- Int32
Окне Указывает размер расположения в байтах для отслеживания доступа. В процессоре на базе x86 этот параметр может иметь одно из двух, 2 или 4. Однако если доступ имеет DkmDataAccessStopMask.Exeмилые, размер должен быть равен 1. В процессоре на базе x64 этот параметр может принимать одно из двух, 2, 4 или 8. Однако если доступ равен DkmDataAccessStopMask.Exeмилые, размер должен быть равен 1. В процессоре на базе процессоров Itanium этот параметр может иметь любую степень числа 2, от 1 до 0x80000000.
- DataItem
- DkmDataItem
[Входные, необязательные] Объект данных, добавляемый в новый экземпляр Дкмрунтимехардваредатабреакпоинт. Передайте значение NULL в случае, если вызывающему объекту не нужно добавлять элемент данных.
Возвращаемое значение
Заполняет Результат вызова этого метода.