Метод 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).

В этом случае буфер аргумента можно считать типом 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

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

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

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

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

Комментарии

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

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

Требования

   
Целевая платформа Рабочий стол
Заголовок dbgeng.h (include Dbgeng.h)