ICorDebugUnmanagedCallback::D ebugEvent – metoda

Upozorní ladicí program, že byla aktivována nativní událost.

Syntaxe

HRESULT DebugEvent (
    [in] LPDEBUG_EVENT  pDebugEvent,
    [in] BOOL           fOutOfBand
);

Parametry

pDebugEvent [v] Ukazatel na nativní událost.

fOutOfBand [in] true, pokud interakce se stavem spravovaného procesu není možné po nespravované události dojít, dokud ladicí program nevolá ICorDebugController::Continue; jinak, false.

Poznámky

Pokud je laděné vlákno Win32 vlákno, nepoužívejte žádné členy rozhraní ladění Win32. Můžete volat ICorDebugController::Continue pouze na vlákno Win32 a pouze v případě, že pokračujete v minulosti událost mimo pásmo.

DebugEvent Zpětné volání neodpovídá standardním pravidlům pro zpětné volání. Při volání DebugEventbude proces v nezpracovaném stavu zastaveného ladění operačního systému. Proces nebude synchronizován. V případě potřeby automaticky zadá synchronizovaný stav pro splnění požadavků na informace o spravovaném kódu, což může vést k jiným vnořeným DebugEvent zpětným voláním.

Volání ICorDebugProcess::ClearCurrentException procesu ignorovat událost výjimky před pokračováním procesu. Volání této metody odesílá DBG_CONTINUE místo DBG_EXCEPTION_NOT_HANDLED na žádosti o pokračování a automaticky vymaže vzdálené zarážky a výjimky s jedním krokem. Události mimo pásmo můžou přijít kdykoli, i když se aplikace, která je laděná, zastaví a když již existuje vynikající událost v pásmu.

Ladicí program by měl okamžitě pokračovat po události zarážky mimo pásmo. Ladicí program by měl používat ICorDebugProcess2::SetUnmanagedBreakpoint a ICorDebugProcess2::ClearUnmanagedBreakpoint metody přidat a odebrat zarážky. Tyto metody přeskočí všechny vzdálené zarážky automaticky. Jediné vzdálené zarážky, které se odesílají, by tedy měly být nezpracované zarážky, které už jsou v instrukčním streamu, například volání funkce Win32 DebugBreak . Nepokoušejte se použít ICorDebugProcess::ClearCurrentException, ICorDebugProcess::GetThreadContext, ICorDebugProcess::SetThreadContext nebo jakýkoli jiný člen rozhraní API ladění.

Požadavky

Platformy: Viz podporované operační systémy .NET.

Záhlaví: CorDebug.idl, CorDebug.h

Knihovna: CorGuids.lib

Verze .NET: K dispozici od rozhraní .NET Framework 1.0

Viz také

• ICorDebugUnmanagedCallback – rozhraní