IDebugDataSpaces3::ReadProcessorSystemData-Methode (dbgeng.h)

Artikel
02/23/2024

Die ReadProcessorSystemData-Methode gibt Daten zum angegebenen Prozessor zurück.

Syntax

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

Parameter

[in] Processor

Gibt den Prozessor an, dessen Daten gelesen werden sollen.

[in] Index

Gibt den zu lesenden Datentyp an. Die folgende Tabelle enthält die gültigen Werte. Nach erfolgreichem Abschluss haben die im Pufferpuffer zurückgegebenen Daten den typ, der von der mittleren Spalte angegeben wird.

Wert	BESCHREIBUNG
DEBUG_DATA_KPCR_OFFSET	Gibt die virtuelle Adresse der Prozessorsteuerungsregion (Processor Control Region, PCR) des Prozessors zurück. In diesem Fall kann davon ausgegangen werden, dass das Argument Buffer den Typ PULONG64 hat.
DEBUG_DATA_KPRCB_OFFSET	Gibt die virtuelle Adresse des Prozessorsteuerungsblocks (PRCB) des Prozessors zurück. In diesem Fall kann davon ausgegangen werden, dass das Argument Buffer den Typ PULONG64 hat.
DEBUG_DATA_KTHREAD_OFFSET	Gibt die virtuelle Adresse der KTHREAD-Struktur für den Systemthread zurück, der auf dem Prozessor ausgeführt wird. In diesem Fall kann davon ausgegangen werden, dass das Argument Buffer den Typ PULONG64 hat.
DEBUG_DATA_BASE_TRANSLATION_VIRTUAL_OFFSET	Gibt die virtuelle Adresse der Basis der Paginginformationen zurück, die dem Betriebssystem oder dem Prozessor gehören. Die Adresse und der Inhalt an der Adresse sind prozessor- und betriebssystemabhängig. In diesem Fall kann davon ausgegangen werden, dass das Argument Buffer den Typ PULONG64 hat.
DEBUG_DATA_PROCESSOR_IDENTIFICATION	Gibt eine Beschreibung des Prozessors zurück. In diesem Fall kann davon ausgegangen werden, dass das Argument Buffer den Typ PDEBUG_PROCESSOR_IDENTIFICATION_ALL hat.
DEBUG_DATA_PROCESSOR_SPEED	Gibt die Geschwindigkeit des Prozessors in MHz zurück. Dies funktioniert möglicherweise nicht in einer bestimmten Sitzung. In diesem Fall kann davon ausgegangen werden, dass das Argument Buffer den Typ PULONG aufweist.

[out] Buffer

Empfängt die Prozessordaten. Nach erfolgreichem Abschluss der Methode kann auf den Inhalt dieses Puffers zugegriffen werden, indem Buffer in den in der obigen Tabelle angegebenen Typ umgewandelt wird.

[in] BufferSize

Gibt die Größe des Pufferpuffers in Byte an. Dies ist die maximale Anzahl von Bytes, die zurückgegeben werden.

[out, optional] DataSize

Empfängt die Größe der Daten in Bytes. Wenn DataSizeNULL ist, werden diese Informationen nicht zurückgegeben.

Rückgabewert

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode war erfolgreich.

Diese Methode kann auch Fehlerwerte zurückgeben. Weitere Informationen finden Sie unter Rückgabewerte .

Hinweise

Diese Methode ist nur im Kernelmodusdebuggen verfügbar.

Informationen zu den PCR-, PRCB- und KTHREAD-Strukturen sowie Informationen zu Pagingtabellen finden Sie unter Microsoft Windows Internals von David Solomon und Mark Russinovich.

Anforderungen

Anforderung	Wert
Zielplattform	Desktop
Kopfzeile	dbgeng.h (dbgeng.h einschließen)