IDebugClient5::AttachKernel 메서드(dbgeng.h)

AttachKernel 메서드는 디버거 엔진을 커널 대상에 연결합니다.

구문

HRESULT AttachKernel(
  [in]           ULONG Flags,
  [in, optional] PCSTR ConnectOptions
);

매개 변수

[in] Flags

디버거가 커널 대상에 연결하는 방법을 제어하는 플래그를 지정합니다. 가능한 값은 다음과 같습니다.

Description
DEBUG_ATTACH_KERNEL_CONNECTION 대상 컴퓨터의 커널에 연결합니다.
DEBUG_ATTACH_EXDI_DRIVER eXDI 드라이버를 사용하여 커널에 연결합니다.

[in, optional] ConnectOptions

커널 대상을 실행하는 컴퓨터와 통신하기 위한 연결 설정을 지정합니다. ConnectOptions의 해석은 플래그 값에 따라 달라집니다.

DEBUG_ATTACH_KERNEL_CONNECTION

ConnectOptions 는 WinDbg 및 KD 명령줄에서 -k 스위치를 따르는 옵션과 동일한 방식으로 해석됩니다. 환경 변수는 -k 스위치에 영향을 주는 것과 동일한 방식으로 ConnectOptions에 영향을 줍니다.

DEBUG_ATTACH_EXDI_DRIVER

eXDI 드라이버는 이 설명서에 설명되어 있지 않습니다. 하드웨어 프로브 또는 하드웨어 시뮬레이터에 대한 eXDI 인터페이스가 있는 경우 디버깅 정보는 Microsoft에 문의하세요.

반환 값

이 메서드는 오류 값을 반환할 수도 있습니다. 자세한 내용은 반환 값을 참조하세요 .

반환 코드 Description
S_OK
메서드를 성공적으로 수행했습니다.

설명

참고WaitForEvent 메서드가 호출될 때까지 엔진이 커널에 완전히 연결되지 않습니다. 커널이 이벤트를 생성한 후에만(예: 초기 중단점) 디버거 세션에서 사용할 수 있게 됩니다.
 
라이브 커널 모드 대상에 연결하는 방법에 대한 자세한 내용은 라이브 Kernel-Mode 대상을 참조하세요.

요구 사항

   
대상 플랫폼 데스크톱
헤더 dbgeng.h(Dbgeng.h 포함)

참고 항목

AttachProcess

GetKernelConnectionOptions

IDebugClient

IDebugClient2

IDebugClient3

IDebugClient4

IDebugClient5

IsKernelDebuggerEnabled