ICorDebugDataTarget-Schnittstelle

Artikel
08/10/2011

Stellt eine Rückrufschnittstelle bereit, die Zugriff auf einen bestimmten Zielprozess bietet.

Methoden

Methode	Beschreibung
ICorDebugDataTarget::GetPlatform-Methode	Stellt Informationen über die Plattform, einschließlich Prozessorarchitektur und Betriebssystem, bereit, auf der der Zielprozess ausgeführt wird.
ICorDebugDataTarget::ReadVirtual-Methode	Ruft einen Block zusammenhängenden Arbeitsspeichers ab, der bei der angegebenen Adresse beginnt, und gibt ihn im angegebenen Puffer zurück.
ICorDebugDataTarget::GetThreadContext-Methode	Fordert den aktuellen Threadkontext für den angegebenen Thread an.

Hinweise

ICorDebugDataTarget und die zugehörigen Methoden weisen folgende Merkmale auf:

Die Debugdienste rufen Methoden für diese Schnittstelle auf, um auf Arbeitsspeicher- und andere Daten im Zielprozess zuzugreifen.
Der Debuggerclient muss diese Schnittstelle dem jeweiligen Ziel (z. B. ein Liveprozess oder ein Speicherabbild) entsprechend implementieren.
Die ICorDebugDataTarget-Methoden können nur in Methoden aufgerufen werden, die in anderen ICorDebug*-Schnittstellen implementiert sind. Dadurch wird sichergestellt, dass der Debuggerclient steuern kann, über welchem Thread und zu welchem Zeitpunkt er aufgerufen wird.
Die ICorDebugDataTarget-Implementierung muss immer aktuelle Informationen über das Ziel zurückgeben.

Während des Aufrufs von ICorDebug*-Schnittstellen (und daher von ICorDebugDataTarget-Methoden) sollte der Zielprozess angehalten und auf keine Weise geändert werden. Wenn das Ziel ein Liveprozess ist und sich dessen Zustand ändert, muss die ICLRDebugging::OpenVirtualProcess-Methode erneut aufgerufen werden, um eine ICorDebugProcess-Ersatzinstanz bereitzustellen.