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

Метод IDebugDataSpaces::ReadProcessorSystemData (dbgeng.h)

  • Статья

Метод ReadProcessorSystemData возвращает данные о указанном процессоре.

Синтаксис

HRESULT ReadProcessorSystemData(
  [in]            ULONG  Processor,
  [in]            ULONG  Index,
  [out]           PVOID  Buffer,
  [in]            ULONG  BufferSize,
  [out, optional] PULONG DataSize
);

Параметры

[in] Processor

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

[in] Index

Указывает тип данных для чтения. В следующей таблице содержатся допустимые значения. После успешного завершения данные, возвращаемые в буфер буфера, имеют тип, заданный средним столбцом.

Значение Описание
DEBUG_DATA_KPCR_OFFSET Возвращает виртуальный адрес области управления процессором (PCR).

В этом случае аргумент Buffer можно считать типом PULONG64.
DEBUG_DATA_KPRCB_OFFSET Возвращает виртуальный адрес блока управления процессором (PRCB).

В этом случае аргумент Buffer можно считать типом PULONG64.
DEBUG_DATA_KTHREAD_OFFSET Возвращает виртуальный адрес структуры KTHREAD для системного потока, работающего на процессоре.

В этом случае аргумент Buffer можно считать типом PULONG64.
DEBUG_DATA_BASE_TRANSLATION_VIRTUAL_OFFSET Возвращает виртуальный адрес базы данных подкачки, принадлежащих операционной системе или процессору. Адрес и содержимое адреса зависят от процессора и операционной системы.

В этом случае аргумент Buffer можно считать типом PULONG64.
DEBUG_DATA_PROCESSOR_IDENTIFICATION Возвращает описание процессора.

В этом случае аргумент Buffer можно считать типом PDEBUG_PROCESSOR_IDENTIFICATION_ALL .
DEBUG_DATA_PROCESSOR_SPEED Возвращает скорость процессора в МГц. Это может не работать в определенном сеансе.

В этом случае аргумент Buffer можно считать типом PULONG.

[out] Buffer

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

[in] BufferSize

Задает размер буфера буфера буфера в байтах. Это максимальное число возвращаемых байтов.

[out, optional] DataSize

Получает размер данных в байтах. Если DataSize имеет значение NULL, эти сведения не возвращаются.

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

Код возврата Описание
S_OK
 Метод выполнен успешно.
 

Этот метод также может возвращать значения ошибок. Дополнительные сведения см. в разделе Возвращаемые значения .

Комментарии

Этот метод доступен только в отладке в режиме ядра.

Сведения о структурах PCR, PRCB и KTHREAD, а также о таблицах подкачки см. в статье Microsoft Windows Internals by David Solomon и Mark Russinovich.

Требования

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