Edit

Share via

IDebugControl7::GetDebuggeeType2 method (dbgeng.h)

  • Article

The GetDebuggeeType2 method describes the nature of the current target.

Syntax

HRESULT GetDebuggeeType2(
  [in]  ULONG  Flags,
  [out] PULONG Class,
  [out] PULONG Qualifier
);

Parameters

[in] Flags

Takes a single flag, DEBUG_EXEC_FLAGS_NONBLOCK, that indicates whether the function GetDebuggeeType2 should own the engine critical section object (g_EngineLock) before finding the debuggee type.

If the Flag is present, then the function will try to own the critical section. If that fails, it will continue without blocking the caller thread.

If the flag is not passed in, then the function will wait for the engine critical section to become available before continuing.

[out] Class

Receives the class of the current target. It will be set to one of the values in the following table.

Value Description
DEBUG_CLASS_UNINITIALIZED There is no current target.
DEBUG_CLASS_KERNEL The current target is a kernel-mode target.
DEBUG_CLASS_USER_WINDOWS The current target is a user-mode target.

[out] Qualifier

Provides more details about the type of the target. Its interpretation depends on the value of Class. When class is DEBUG_CLASS_UNINITIALIZED, Qualifier returns zero. The following values are applicable for kernel-mode targets.

Value Description
DEBUG_KERNEL_CONNECTION The current target is a live kernel being debugged in the standard way (using a COM port, 1394 bus, or named pipe).
DEBUG_KERNEL_LOCAL The current target is the local kernel.
DEBUG_KERNEL_EXDI_DRIVER The current target is a live kernel connected using eXDI drivers.
DEBUG_KERNEL_SMALL_DUMP The current target is a kernel-mode Small Memory Dump file.
DEBUG_KERNEL_DUMP The current target is a kernel-mode Kernel Memory Dump file.
DEBUG_KERNEL_FULL_DUMP The current target is a kernel-mode Complete Memory Dump file.
 

The following values are applicable for user-mode targets.

Value Description
DEBUG_USER_WINDOWS_PROCESS The current target is a user-mode process on the same computer as the debugger engine.
DEBUG_USER_WINDOWS_PROCESS_SERVER The current target is a user-mode process connected using a process server.
DEBUG_USER_WINDOWS_SMALL_DUMP The current target is a user-mode Minidump file.
DEBUG_USER_WINDOWS_DUMP The current target is a Full User-Mode Dump file.

Return value

This method does not return a value.

Requirements

Requirement Value
Target Platform Desktop
Header dbgeng.h

See also

IDebugControl7