Metodo IDebugRegisters2::SetValues2 (dbgeng.h)

  • Articolo

Il metodo SetValues2 imposta il valore di diversi registri della 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 per la query.

I valori possibili sono elencati nella tabella seguente.

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

[in] Count

Specifica il numero di registri per i quali 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 gli indici sono NULL, viene invece usato Start.

[in] Start

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

[in] Values

Matrice che contiene i valori a cui impostare i registri. Il numero di elementi che contiene 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 degli errori possibili, vedere Valori HRESULT.

Codice restituito Descrizione
S_OK
 Il metodo è stato eseguito correttamente.

Commenti

Il motore esegue al meglio 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. Le conversioni a virgola mobile e intere verranno eseguite anche se necessario.

Se il valore restituito non è S_OK, alcuni dei 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 dell'origine del registro.

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

Requisiti

Requisito Valore
Piattaforma di destinazione Desktop
Intestazione dbgeng.h (include DbgEng.h)

Vedi anche

IDebugRegisters2

SetValue

SetValues