Metodo IDebugRegisters2::GetValues2 (dbgeng.h)

Articolo
04/18/2024

Il metodo GetValues2 recupera il valore di diversi registri della destinazione.

Sintassi

HRESULT GetValues2(
  [in]           ULONG        Source,
  [in]           ULONG        Count,
  [in, optional] PULONG       Indices,
  [in]           ULONG        Start,
  [out]          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 i cui valori sono richiesti.

[in, optional] Indices

Specifica una matrice che contiene gli indici dei registri da cui ottenere 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 letti consecutivamente a partire da questo indice. In caso contrario, viene ignorata.

[out] Values

Riceve i valori dei 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.
E_INVALIDARG	Il valore dell'indice di uno dei registri è maggiore del numero di registri nel computer di destinazione. I risultati parziali potrebbero essere stati ottenuti; tali registri che non possono essere letti avranno il tipo DEBUG_VALUE_INVALID.

Commenti

Se il valore restituito non è S_OK, alcuni dei registri potrebbero essere ancora stati letti. Se la destinazione non è accessibile, il tipo restituito è E_UNEXPECTED e i valori non vengono modificati. In caso contrario, i valori contengono risultati parziali e i registri che non possono essere letti avranno tipo DEBUG_VALUE_INVALID. L'ambiguità nel caso del valore restituito E_UNEXPECTED può essere evitata impostando la memoria di Valori su zero prima di chiamare questo metodo.

Il metodo GetValues 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

GetValue

GetValues

IDebugRegisters2

Condividi tramite