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

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

  • Статья

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

Синтаксис

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

Параметры

processor

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

address

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

buf

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

size

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

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

None

Remarks

При написании 32-разрядного кода следует использовать ReadControlSpace . Дополнительные сведения см. в разделе 32-разрядные и 64-разрядные указатели .

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

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

void ReadTypedControlSpace32(
    _Proc,
    _Addr,
    _Buf
);

_Proc

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

_Addr

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

_Buf

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

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

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

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

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

void ReadTypedControlSpace64(
    _Proc,
    _Addr,
    _Buf
);

_Proc

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

_Addr

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

_Buf

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

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

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

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

Требования

Требование Значение
Целевая платформа Персональный компьютер
Верхняя часть wdbgexts.h (включая Wdbgexts.h, Dbgeng.h)