Interfaccia ICorDebugDataTarget

Articolo
08/11/2011

Fornisce un'interfaccia di callback che consente di accedere a un determinato processo di destinazione.

Metodi

Metodo	Descrizione
Metodo ICorDebugDataTarget::GetPlatform	Fornisce informazioni sulla piattaforma, compresi l'architettura del processore e il sistema operativo, su cui è in esecuzione il processo di destinazione.
Metodo ICorDebugDataTarget::ReadVirtual	Ottiene un blocco di memoria contigua che inizia in corrispondenza dell'indirizzo specificato e lo restituisce nel buffer fornito.
Metodo ICorDebugDataTarget::GetThreadContext	Richiede il contesto corrente del thread specificato.

Note

L'oggetto ICorDebugDataTarget e i relativi metodi presentano le caratteristiche seguenti:

I servizi di debug chiamano metodi su questa interfaccia per accedere alla memoria e agli altri dati nel processo di destinazione.
Il client del debugger deve implementare questa interfaccia come necessario per il processo di destinazione in questione (ad esempio, un processo attivo o un'immagine della memoria).
I metodi ICorDebugDataTarget possono essere richiamati solo dall'interno di metodi implementati in altre interfacce ICorDebug*. Ciò garantisce che il client del debugger sia in grado di determinare il thread e il momento in cui viene richiamato.
L'implementazione di ICorDebugDataTarget deve restituire sempre informazioni aggiornate sulla destinazione.

Mentre vengono chiamate le interfacce ICorDebug* (e pertanto i metodi ICorDebugDataTarget), il processo di destinazione deve rimanere interrotto e non subire alcun tipo di modifica. Se la destinazione è un processo attivo e il relativo stato cambia è necessario chiamare nuovamente il metodo ICLRDebugging::OpenVirtualProcess per fornire un'istanza di ICorDebugProcess sostitutiva.