ReadControlSpace64-Funktion (wdbgexts.h)

Die ReadControlSpace64-Funktion liest den prozessorspezifischen Steuerbereich in das Array, auf das buf verweist.

Syntax

void ReadControlSpace64(
  USHORT  processor,
  ULONG64 address,
  PVOID   buf,
  ULONG   size
);

Parameter

processor

Gibt die Anzahl des Prozessors an, dessen Steuerraum gelesen werden soll.

address

Gibt die Adresse des Steuerbereichs an.

buf

Gibt die Adresse eines Bytearrays an, das die Steuerungsbereichsdaten enthalten soll.

size

Gibt die Anzahl der Bytes im Array an, auf das buf verweist.

Rückgabewert

Keine

Bemerkungen

Wenn Sie 32-Bit-Code schreiben, sollten Sie stattdessen ReadControlSpace verwenden. Weitere Informationen finden Sie unter 32-Bit-Zeiger und 64-Bit-Zeiger .

Wenn Sie eine WdbgExts-Erweiterung schreiben, schließen Sie wdbgexts.h ein. Wenn Sie eine DbgEng-Erweiterung schreiben, die diese Funktion aufruft, schließen Sie wdbgexts.h vor dbgeng.h ein (ausführliche Informationen finden Sie unter Schreiben von DbgEng-Erweiterungscode ).

Das ReadTypedControlSpace32-Makro ist ein dünner Wrapper um die ReadControlSpace64-Funktion . Es wird als Benutzerfreundlichkeit zum Lesen des prozessorspezifischen Steuerungsbereichs in eine -Struktur bereitgestellt.

void ReadTypedControlSpace32(
    _Proc,
    _Addr,
    _Buf
);

_Proc

Gibt die Anzahl des Prozessors an, dessen Steuerraum gelesen werden soll.

_Addr

Gibt die Adresse des Steuerbereichs an.

_Buf

Gibt das Objekt an, in das die Steuerraumdaten gelesen werden.

Rückgabewert

Dieses Makro gibt keinen Wert zurück.

Die für dieses Makro bereitgestellten Parameter sind identisch mit denen, die für die ReadControlSpace64-Funktion bereitgestellt werden, mit der Ausnahme, dass die Struktur direkt bereitgestellt werden kann, anstatt einen Zeiger auf eine Struktur und deren Größe bereitzustellen.

Das ReadTypedControlSpace64-Makro ist ein dünner Wrapper um die ReadControlSpace64-Funktion . Es wird als Benutzerfreundlichkeit zum Lesen des prozessorspezifischen Steuerungsbereichs in eine -Struktur bereitgestellt.

void ReadTypedControlSpace64(
    _Proc,
    _Addr,
    _Buf
);

_Proc

Gibt die Anzahl des Prozessors an, dessen Steuerraum gelesen werden soll.

_Addr

Gibt die Adresse des Steuerbereichs an.

_Buf

Gibt das Objekt an, in das die Steuerraumdaten gelesen werden.

Rückgabewert

Dieses Makro gibt keinen Wert zurück.

Die für dieses Makro bereitgestellten Parameter sind identisch mit denen, die für die ReadControlSpace64-Funktion bereitgestellt werden, mit der Ausnahme, dass die Struktur direkt bereitgestellt werden kann, anstatt einen Zeiger auf eine Struktur und deren Größe bereitzustellen.

Anforderungen

Anforderung	Wert
Zielplattform	Desktop
Kopfzeile	wdbgexts.h (include Wdbgexts.h, Dbgeng.h)