ICorDebugDataTarget, interface

Article
08/10/2011

Fournit une interface de rappel qui permet d'accéder à un processus cible particulier.

Méthodes

Méthode	Description
ICorDebugDataTarget::GetPlatform, méthode	Fournit des informations sur la plateforme, notamment l'architecture de processeur et le système d'exploitation, sur laquelle le processus cible s'exécute.
ICorDebugDataTarget::ReadVirtual, méthode	Obtient un bloc de mémoire contiguë qui démarre à l'adresse spécifiée, et le retourne dans la mémoire tampon fournie.
ICorDebugDataTarget::GetThreadContext, méthode	Demande le contexte de thread actuel du thread spécifié.

Notes

ICorDebugDataTarget et ses méthodes ont les caractéristiques suivantes :

Les services de débogage appellent des méthodes sur cette interface pour accéder à la mémoire et à d'autres données dans le processus cible.
Le client de débogueur doit implémenter cette interface de manière appropriée pour la cible particulière (par exemple, un processus en cours ou une image mémoire).
Les méthodes ICorDebugDataTarget ne peuvent être appelées qu'à partir de méthodes implémentées dans d'autres interfaces ICorDebug*. Cela garantit que le client de débogueur garde le contrôle sur le choix du thread sur lequel la méthode est appelée et du moment de l'appel.
L'implémentation ICorDebugDataTarget doit toujours retourner des informations à jour à propos de la cible.

Le processus cible doit être arrêté et ne doit pas être modifié pendant que les interfaces ICorDebug* (et par conséquent, les méthodes ICorDebugDataTarget) sont appelées. Si la cible est un processus en cours et que son état change, la méthode ICLRDebugging::OpenVirtualProcess doit être de nouveau appelée pour fournir une instance ICorDebugProcess de remplacement.