Método IDebugDataSpaces4::ReadProcessorSystemData (dbgeng.h)

Artículo
02/06/2025

El método ReadProcessorSystemData devuelve datos sobre el procesador especificado.

Sintaxis

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

Parámetros

[in] Processor

Especifica el procesador cuyos datos se van a leer.

[in] Index

Especifica el tipo de datos que se va a leer. La tabla siguiente contiene los valores válidos. Después de completarse correctamente, los datos devueltos en el búfer buffer tienen el tipo especificado por la columna central.

Valor	Descripción
DEBUG_DATA_KPCR_OFFSET	Devuelve la dirección virtual de la región de control del procesador (PCR). En este caso, el argumento buffer se puede considerar que tiene PULONG64 de tipo.
DEBUG_DATA_KPRCB_OFFSET	Devuelve la dirección virtual del bloque de control de procesador (PRCB) del procesador. En este caso, el argumento buffer se puede considerar que tiene PULONG64 de tipo.
DEBUG_DATA_KTHREAD_OFFSET	Devuelve la dirección virtual de la estructura KTHREAD para el subproceso del sistema que se ejecuta en el procesador. En este caso, el argumento buffer se puede considerar que tiene PULONG64 de tipo.
DEBUG_DATA_BASE_TRANSLATION_VIRTUAL_OFFSET	Devuelve la dirección virtual de la base de la información de paginación que pertenece al sistema operativo o al procesador. La dirección y el contenido de la dirección dependen del procesador y del sistema operativo. En este caso, el argumento buffer se puede considerar que tiene PULONG64 de tipo.
DEBUG_DATA_PROCESSOR_IDENTIFICATION	Devuelve una descripción del procesador. En este caso, el argumento buffer se puede considerar que tiene el tipo PDEBUG_PROCESSOR_IDENTIFICATION_ALL .
DEBUG_DATA_PROCESSOR_SPEED	Devuelve la velocidad del procesador en MHz. Esto puede no funcionar en una sesión determinada. En este caso, el argumento buffer se puede considerar que tiene el tipo PULONG.

[out] Buffer

Recibe los datos del procesador. Tras completar correctamente el método, se puede acceder al contenido de este búfer mediante la conversión de Búfer al tipo especificado en la tabla anterior.

[in] BufferSize

Especifica el tamaño en bytes del búfer Búfer. Este es el número máximo de bytes que se devolverán.

[out, optional] DataSize

Recibe el tamaño de los datos en bytes. Si DataSize es NULL, esta información no se devuelve.

Valor devuelto

Código devuelto	Descripción
S_OK	El método se realizó correctamente.

Este método también puede devolver valores de error. Consulte valores devueltos para obtener más información.

Observaciones

Este método solo está disponible en la depuración en modo kernel.

Para obtener información sobre las estructuras PCR, PRCB y KTHREAD, así como información sobre las tablas de paginación, consulte Microsoft Windows Internals por David Solomon y Mark Russinovich.

Requisitos

Requisito	Valor
de la plataforma de destino de	Escritorio
encabezado de	dbgeng.h (include Dbgeng.h)

Compartir a través de