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

Статья
02/06/2025

Метод 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). В этом случае аргумент буфера можно считать типом PULONG64.
DEBUG_DATA_KPRCB_OFFSET	Возвращает виртуальный адрес блока управления процессором процессора (PRCB). В этом случае аргумент буфера можно считать типом PULONG64.
DEBUG_DATA_KTHREAD_OFFSET	Возвращает виртуальный адрес структуры KTHREAD для системного потока, работающего на процессоре. В этом случае аргумент буфера можно считать типом PULONG64.
DEBUG_DATA_BASE_TRANSLATION_VIRTUAL_OFFSET	Возвращает виртуальный адрес базы данных разбиения по страницам, принадлежащих операционной системе или процессору. Адрес и содержимое адреса зависят от процессора и операционной системы. В этом случае аргумент буфера можно считать типом PULONG64.
DEBUG_DATA_PROCESSOR_IDENTIFICATION	Возвращает описание процессора. В этом случае аргумент буфера можно считать типом PDEBUG_PROCESSOR_IDENTIFICATION_ALL.
DEBUG_DATA_PROCESSOR_SPEED	Возвращает скорость процессора в МГц. Это может не работать в определенном сеансе. В этом случае аргумент буфера можно считать типом PULONG.

[out] Buffer

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

[in] BufferSize

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

[out, optional] DataSize

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

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

Возвращаемый код	Описание
S_OK	Метод был успешным.

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

Замечания

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

Сведения о структурах PCR, PRCB и KTHREAD, а также сведения о таблицах разбиения по страницам см. в разделе внутренних элементов Microsoft Windows Дэвид Соломон и Марк Руссинович.

Требования

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

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