Прочитать на английском

Поделиться через


Функция ReadControlSpace64 (wdbgexts.h)

Функция ReadControlSpace64 считывает пространство управления для процессора в массив, на который указывает buf.

Синтаксис

C++
void ReadControlSpace64(
  USHORT  processor,
  ULONG64 address,
  PVOID   buf,
  ULONG   size
);

Параметры

processor

Указывает номер процессора, пространство управления которого должно быть прочитано.

address

Задает адрес пространства управления.

buf

Указывает адрес массива байтов для хранения данных пространства управления.

size

Указывает количество байтов в массиве, на которое указывает buf.

Возвращаемое значение

Никакой

Замечания

Если вы пишете 32-разрядный код, вместо этого следует использовать ReadControlSpace. Дополнительные сведения см. в 32-разрядных указателей и 64-разрядны х указателей.

Если вы пишете расширение WdbgExts, включите wdbgexts.h. Если вы пишете расширение DbgEng, которое вызывает эту функцию, включите wdbgexts.h до dbgeng.h (дополнительные сведения см. в записи кода расширения DbgEng).

Макрос ReadTypedControlSpace32 — это тонкая оболочка вокруг функции ReadControlSpace64. Он предоставляется в качестве удобства для чтения пространства управления для конкретного процессора в структуру.

C++
void ReadTypedControlSpace32(
    _Proc,
    _Addr,
    _Buf
);

_Proc

Указывает номер процессора, пространство управления которого должно быть прочитано.

_Addr

Задает адрес пространства управления.

_Buf

Указывает объект, в который считываются данные пространства управления.

возвращаемое значение

Этот макрос не возвращает значение.

Параметры, предоставленные этому макросу, совпадают с параметрами, предоставленными функции ReadControlSpace64, за исключением того, что вместо указания указателя на структуру и его размер структура может быть предоставлена напрямую.

Макрос ReadTypedControlSpace64 — это тонкая оболочка вокруг функции ReadControlSpace64. Он предоставляется в качестве удобства для чтения пространства управления для конкретного процессора в структуру.

C++
void ReadTypedControlSpace64(
    _Proc,
    _Addr,
    _Buf
);

_Proc

Указывает номер процессора, пространство управления которого должно быть прочитано.

_Addr

Задает адрес пространства управления.

_Buf

Указывает объект, в который считываются данные пространства управления.

возвращаемое значение

Этот макрос не возвращает значение.

Параметры, предоставленные этому макросу, совпадают с параметрами, предоставленными функции ReadControlSpace64, за исключением того, что вместо указания указателя на структуру и его размер структура может быть предоставлена напрямую.

Требования

Требование Ценность
целевая платформа Настольный
заголовка wdbgexts.h (include Wdbgexts.h, Dbgeng.h)