Metodo IDebugRegisters2::SetValues2 (dbgeng.h)

Articolo
02/06/2025

Il metodo SetValues2 imposta il valore di diversi registri di destinazione.

Sintassi

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

Parametri

[in] Source

Specifica l'origine del registro su cui eseguire la query.

I valori possibili sono elencati nella tabella seguente.

Valore	Registrare l'origine
DEBUG_REGSRC_DEBUGGEE	Recuperare le informazioni del registro dalla destinazione.
DEBUG_REGSRC_EXPLICIT	Recuperare le informazioni del registro dal contesto di registrazione esplicito corrente .
DEBUG_REGSRC_FRAME	Recuperare le informazioni del registro dal contesto di registrazione dell'ambito corrente. Nota rimozione dello stack non garantisce un aggiornamento accurato del contesto del registro, pertanto il contesto del registro del frame di ambito potrebbe non essere accurato in tutti i casi.

[in] Count

Specifica il numero di registri per cui impostare i valori.

[in, optional] Indices

Specifica una matrice che contiene gli indici dei registri per cui impostare i valori. Il numero di elementi in questa matrice è Count. Se indici è NULL, viene invece utilizzato Start.

[in] Start

Se indice è NULL, i registri verranno impostati consecutivamente a partire da questo indice. In caso contrario, viene ignorato.

[in] Values

Matrice che contiene i valori a cui impostare i registri. Il numero di elementi contenuti in questa matrice è Count. Per una descrizione di questo tipo di parametro, vedere DEBUG_VALUE.

Valore restituito

Questo elenco non contiene tutti gli errori che potrebbero verificarsi. Per un elenco dei possibili errori, vedere valori HRESULT.

Codice restituito	Descrizione
S_OK	Il metodo ha avuto esito positivo.

Osservazioni

Il motore esegue il cast dei valori in Valori nel tipo dei registri; questa conversione è uguale a quella eseguita da CoerceValue. Se il valore è maggiore di quello che il registro può contenere, vengono eliminati i bit meno significativi. Anche le conversioni a virgola mobile e integer verranno eseguite se necessario.

Se il valore restituito non è S_OK, alcuni registri potrebbero essere ancora stati impostati.

Quando viene modificata una sottoregister, viene modificato anche il registro che lo contiene.

Il metodo SetValues esegue la stessa attività di questo metodo, ma usa sempre la destinazione come origine del registro.

Per una panoramica dell'interfaccia di IDebugRegisters di e di altri metodi correlati al registro, vedere Registers.

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Desktop
intestazione	dbgeng.h (include DbgEng.h)

Vedere anche

IDebugRegisters2

SetValue

SetValues

Condividi tramite