IDebugHost::GetCurrentContext 메서드(dbgmodel.h)

  • 아티클

GetCurrentContext 메서드는 디버거 호스트의 현재 상태를 나타내는 인터페이스를 반환합니다. 정확한 의미는 호스트에 맡기지만 일반적으로 디버그 호스트의 사용자 인터페이스에서 활성 상태인 세션, 프로세스 및 주소 공간과 같은 항목을 포함합니다. 반환된 컨텍스트 개체는 호출자에게는 대체로 불투명하지만 디버그 호스트에 대한 호출 간에 전달하는 중요한 개체입니다. 호출자가 메모리를 읽는 instance 경우 메모리를 읽는 프로세스 및 주소 공간을 알아야 합니다. 이 개념은 이 메서드에서 반환되는 컨텍스트 개체의 개념에 캡슐화됩니다.

데이터 모델의 모든 개체와 기호에는 필요에 따라 이와 관련된 컨텍스트 정보가 있습니다. 또한 컨텍스트가 한 개체에서 기존 개체의 속성으로 만들어진 새 개체로 전달되는 것이 일반적입니다. 디버그 호스트 자체에서 만든 이러한 개체는 반환된 개체 내에 추가 컨텍스트 정보를 포함할 수 있습니다(예: 스레드의 Stack 속성은 스택이 컨텍스트 내에서 참조하는 스레드에 대한 정보를 포함할 수 있음).

구문

HRESULT GetCurrentContext(
  IDebugHostContext **context
);

매개 변수

context

호스트의 현재 컨텍스트를 나타내는 개체가 여기에 반환됩니다.

반환 값

이 메서드는 성공 또는 실패를 나타내는 HRESULT를 반환합니다. 컨텍스트 정보의 개념이 없는 호스트는 여기에 E_NOTIMPL 반환할 수 있습니다.

설명

코드 예제

ComPtr<IDebugHost> spHost; /* get the debug host */

ComPtr<IDebugHostContext> spContext;
if (SUCCEEDED(spHost->GetCurrentContext(&spContext)))
{
    // spContext now contains an opaque object representing the current UI 
    // state of the debugger (e.g.: what session/process/thread the debug UI 
    // is focused on)
}

요구 사항

요구 사항 값
헤더 dbgmodel.h

추가 정보

IDebugHost 인터페이스