ICorDebugDataTarget, interface

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

Méthodes

Méthode Description
GetPlatform, méthode Fournit des informations sur la plateforme, y compris l’architecture du processeur et le système d’exploitation sur lequel le processus cible est en cours d’exécution.
ReadVirtual, méthode Obtient un bloc de mémoire contiguë commençant à l’adresse spécifiée et le retourne dans la mémoire tampon fournie.
GetThreadContext, méthode Demande le contexte de thread actuel pour le thread spécifié.

Notes

ICorDebugDataTarget et ses méthodes présentent 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ébogage doit implémenter cette interface de façon appropriée pour la cible particulière (par exemple, un processus actif ou un vidage de la 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ébogage a le contrôle du thread sur lequel il est appelé, et du moment auquel il est appelé.

  • L’implémentation de ICorDebugDataTarget doit toujours retourner des informations à jour sur la cible.

Le processus cible devrait être arrêté et n’être modifié en aucune manière pendant l’appel des interfaces ICorDebug* (et par conséquent des méthodes ICorDebugDataTarget). Si la cible est un processus actif dont l’état change, la méthode ICLRDebugging::OpenVirtualProcess doit être de nouveau appelée pour fournir une instance ICorDebugProcess de remplacement.

Notes

Cette interface ne prend pas en charge l'appel à distance, que ce soit entre ordinateurs ou entre processus.

Spécifications

Plateformes : Consultez Configuration requise.

En-tête : CorDebug.idl, CorDebug.h

Bibliothèque : CorGuids.lib

Versions de .NET Framework : Disponible depuis la version 4

Voir aussi