Metodo IDebugRegisters2::GetPseudoDescription (dbgeng.h)

  • Articolo

Il metodo GetPseudoDescription restituisce una descrizione di uno pseudoregistro, incluso il nome e il tipo.

Sintassi

HRESULT GetPseudoDescription(
  [in]            ULONG    Register,
  [out, optional] PSTR     NameBuffer,
  [in]            ULONG    NameBufferSize,
  [out, optional] PULONG   NameSize,
  [out, optional] PULONG64 TypeModule,
  [out, optional] PULONG   TypeId
);

Parametri

[in] Register

Specifica l'indice dello pseudoregistro la cui descrizione è richiesta. L'indice è sempre compreso tra zero e il numero di pseudoregistri (restituiti da GetNumberPseudoRegisters) meno uno.

[out, optional] NameBuffer

Riceve il nome dello pseudoregistrato. Se NameBuffer è NULL, queste informazioni non vengono restituite.

[in] NameBufferSize

Specifica le dimensioni, in caratteri, del buffer specificato da NameBuffer . Questa dimensione include lo spazio per il carattere di terminazione '\0'.

[out, optional] NameSize

Riceve le dimensioni in caratteri del nome dello pseudoregistro. Questa dimensione include lo spazio per il carattere di terminazione '\0'. Se NameSize è NULL, queste informazioni non vengono restituite.

[out, optional] TypeModule

Riceve l'indirizzo di base del modulo a cui appartiene il tipo del registro. Se il tipo del registro non è noto, viene restituito zero. Se TypeModule è NULL, non vengono restituite informazioni.

[out, optional] TypeId

Riceve l'ID del tipo all'interno del modulo restituito in TypeModule. Se l'ID del tipo non è noto, viene restituito zero. Se TypeId è NULL, non viene restituita alcuna informazione.

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 è stato eseguito correttamente.
E_FAIL
 La descrizione del registro non era disponibile

Commenti

Le descrizioni non sono sempre disponibili per tutti i registri. Se uno pseudoregistro non ha un valore, ad esempio $eventip non avrà un valore prima che si sia verificato un evento o non sia possibile determinare un tipo per uno pseudoregistrato, questo metodo restituirà E_FAIL.

Per una panoramica dell'interfaccia IDebugRegisters e di altri metodi correlati al registro, vedere Registers.For an overview of the IDebugRegisters interface and other register-related methods, see Registers.

Requisiti

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

Vedi anche

GetNumberPseudoRegisters

GetPseudoIndexByName

IDebugRegisters2