IDebugRegisters2::SetValues2-Methode (dbgeng.h)

Artikel
02/06/2025

Mit der SetValues2- -Methode wird der Wert mehrerer des Zielsregistriert.

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 zu abfragende Registerquelle an.

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

Wert	Quelle registrieren
DEBUG_REGSRC_DEBUGGEE	Abrufen von Registrierungsinformationen aus dem Ziel.
DEBUG_REGSRC_EXPLICIT	Abrufen von Registrierungsinformationen aus dem aktuellen expliziten Registrieren des Kontexts.
DEBUG_REGSRC_FRAME	Abrufen von Registrierungsinformationen aus dem Registerkontext des aktuellen Bereichs. Hinweis Stack-Abspannen garantiert keine genaue Aktualisierung des Registerkontexts, sodass der Registerkontext des Bereichsrahmens in allen Fällen möglicherweise nicht 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-ist, werden die Register fortlaufend beginnend mit 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 der möglichen Fehler finden Sie unter HRESULT-Werte.

Rückgabecode	Beschreibung
S_OK	Die Methode war erfolgreich.

Bemerkungen

Das Modul macht es am besten, die Werte in Werte in den Typ der Register zu umwandeln; Diese Konvertierung ist identisch mit der von CoerceValueausgeführten. Wenn der Wert größer ist als das, was das Register enthalten kann, werden die am wenigsten signifikanten Bits verworfen. Gleitkomma- und Ganzzahlkonvertierungen werden bei Bedarf ebenfalls ausgeführt.

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

Wenn eine Unterregisterregister geändert wird, wird das Register, das es enthält, ebenfalls geändert.

Die Methode SetValues dieselbe Aufgabe wie diese Methode ausführt, verwendet aber immer das Ziel als Registerquelle.

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

Anforderungen

Anforderung	Wert
Zielplattform-	Desktop
Header-	dbgeng.h (include DbgEng.h)

Siehe auch

IDebugRegisters2

SetValue-

SetValues-

Freigeben über