IDebugDataSpaces4::ReadProcessorSystemData-Methode (dbgeng.h)

Artikel
02/06/2025

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 Auftragsverarbeiter 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 Puffer zurückgegebenen Daten Buffer den Typ der mittleren Spalte angegeben.

Wert	Beschreibung
DEBUG_DATA_KPCR_OFFSET	Gibt die virtuelle Adresse der Prozessorsteuerungsregion (Processor Control Region, PCR) des Prozessors zurück. In diesem Fall kann das Argument Buffer als Typ PULONG64 betrachtet werden.
DEBUG_DATA_KPRCB_OFFSET	Gibt die virtuelle Adresse des Prozessorsteuerungsblocks (Processor Control Block, PRCB) des Prozessors zurück. In diesem Fall kann das Argument Buffer als Typ PULONG64 betrachtet werden.
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 das Argument Buffer als Typ PULONG64 betrachtet werden.
DEBUG_DATA_BASE_TRANSLATION_VIRTUAL_OFFSET	Gibt die virtuelle Adresse der Basis der Auslagerungsinformationen im Besitz des Betriebssystems oder des Prozessors zurück. Die Adresse und der Inhalt an der Adresse sind prozessor- und betriebssystemabhängig. In diesem Fall kann das Argument Buffer als Typ PULONG64 betrachtet werden.
DEBUG_DATA_PROCESSOR_IDENTIFICATION	Gibt eine Beschreibung des Prozessors zurück. In diesem Fall kann das Argument Buffer als Typ PDEBUG_PROCESSOR_IDENTIFICATION_ALL betrachtet werden.
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 das Argument Buffer als typ PULONG betrachtet werden.

[out] Buffer

Empfängt die Auftragsverarbeiterdaten. Nach erfolgreichem Abschluss der Methode kann auf den Inhalt dieses Puffers zugegriffen werden, indem sie Puffer- in den in der obigen Tabelle angegebenen Typ umwandeln.

[in] BufferSize

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

[out, optional] DataSize

Empfängt die Größe der Daten in Byte. Wenn DataSize-NULL-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.

Bemerkungen

Diese Methode ist nur im Kernelmodusdebugging 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
Header-	dbgeng.h (include Dbgeng.h)

Freigeben über