Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
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 pseudoregistro. Se NameBuffer è null, queste informazioni non vengono restituite.
[in] NameBufferSize
Specifica le dimensioni, in caratteri, del buffer specificato 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 vengono restituite informazioni.
Valore restituito
Questo elenco non contiene tutti gli errori che potrebbero verificarsi. Per un elenco dei possibili errori, vedere valori HRESULT.
Codice restituito | Descrizione |
---|---|
|
Il metodo ha avuto esito positivo. |
|
La descrizione per il registro non era disponibile |
Osservazioni
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 oppure non è possibile determinare un tipo per uno pseudoregistro, questo metodo restituirà E_FAIL.
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) |