IDebugRegisters2::SetValues2-Methode (dbgeng.h)

Artikel
08/07/2023

Die SetValues2-Methode legt den Wert mehrerer Register des Ziels fest.

Syntax

HRESULT SetValues2(
  [in]           ULONG        Source,
  [in]           ULONG        Count,
  [in, optional] PULONG       Indices,
  [in]           ULONG        Start,
  [in]           PDEBUG_VALUE Values
);

Parameter

[in] Source

Gibt die abzufragende Registrierungsquelle an.

Die möglichen Werte sind in der folgenden Tabelle aufgeführt.

Wert	Quelle registrieren
DEBUG_REGSRC_DEBUGGEE	Rufen Sie Registrierungsinformationen vom Ziel ab.
DEBUG_REGSRC_EXPLICIT	Ruft Registrierungsinformationen aus dem aktuellen expliziten Registerkontext ab.
DEBUG_REGSRC_FRAME	Ruft Registerinformationen aus dem Registerkontext des aktuellen Bereichs ab. Hinweis Die Stapelentladung garantiert keine genaue Aktualisierung des Registerkontexts, sodass der Registerkontext des Bereichsrahmens möglicherweise nicht in allen Fällen korrekt ist.

[in] Count

Gibt die Anzahl der Register an, für die die Werte festgelegt werden sollen.

[in, optional] Indices

Gibt ein Array an, das die Indizes der Register enthält, für die die Werte festgelegt werden sollen. Die Anzahl der Elemente in diesem Array ist Count. Wenn IndizesNULL ist, wird stattdessen Start verwendet.

[in] Start

Wenn IndizesNULL sind, werden die Register nacheinander ab diesem Index festgelegt. Andernfalls wird sie ignoriert.

[in] Values

Ein Array, das die Werte enthält, auf die die Register festgelegt werden sollen. Die Anzahl der Elemente, die dieses Array enthält, ist Count. Eine Beschreibung dieses Parametertyps finden Sie unter DEBUG_VALUE .

Rückgabewert

Diese Liste enthält nicht alle fehler, die auftreten können. Eine Liste möglicher Fehler finden Sie unter HRESULT-Werte.

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode war erfolgreich.

Hinweise

Die Engine tut ihr Bestes, um die Werte in Werte in den Typ der Register zu umwandeln. Diese Konvertierung entspricht der Konvertierung, die von CoerceValue ausgeführt wird. Wenn der Wert größer ist als der Wert, der im Register enthalten sein kann, werden die am wenigsten signifikanten Bits gelöscht. Bei Bedarf werden auch Gleitkomma- und Ganzzahlkonvertierungen ausgeführt.

Wenn der Rückgabewert nicht S_OK ist, wurden möglicherweise noch einige der Register festgelegt.

Wenn ein Unterregister geändert wird, wird auch das Register, das es enthält, geändert.

Die SetValues-Methode führt dieselbe Aufgabe wie diese Methode aus, verwendet jedoch immer das Ziel als Registerquelle.

Eine Übersicht über die IDebugRegisters-Schnittstelle und andere registerbezogene Methoden finden Sie unter Register.

Anforderungen

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

Weitere Informationen

IDebugRegisters2

SetValue

SetValues

Freigeben über