Método IDebugControl7::GetDebuggeeType2 (dbgeng.h)
El método GetDebuggeeType2 describe la naturaleza del destino actual.
Sintaxis
HRESULT GetDebuggeeType2(
[in] ULONG Flags,
[out] PULONG Class,
[out] PULONG Qualifier
);
Parámetros
[in] Flags
Toma una sola marca, DEBUG_EXEC_FLAGS_NONBLOCK, que indica si la función GetDebuggeeType2 debe poseer el objeto de sección crítico del motor (g_EngineLock) antes de buscar el tipo depurado.
Si la marca está presente, la función intentará poseer la sección crítica. Si se produce un error, continuará sin bloquear el subproceso del autor de la llamada.
Si la marca no se pasa, la función esperará a que la sección crítica del motor esté disponible antes de continuar.
[out] Class
Recibe la clase del destino actual. Se establecerá en uno de los valores de la tabla siguiente.
| Valor | Descripción |
|---|---|
| DEBUG_CLASS_UNINITIALIZED | No hay ningún destino actual. |
| DEBUG_CLASS_KERNEL | El destino actual es un destino en modo kernel. |
| DEBUG_CLASS_USER_WINDOWS | El destino actual es un destino en modo de usuario. |
[out] Qualifier
Proporciona más detalles sobre el tipo del destino. Su interpretación depende del valor de Class. Cuando la clase es DEBUG_CLASS_UNINITIALIZED, Qualifier devuelve cero. Los siguientes valores son aplicables a los destinos en modo kernel.
| Valor | Descripción |
|---|---|
| DEBUG_KERNEL_CONNECTION | El destino actual es un kernel activo que se depura de forma estándar (mediante un puerto COM, un bus de 1394 o una canalización con nombre). |
| DEBUG_KERNEL_LOCAL | El destino actual es el kernel local. |
| DEBUG_KERNEL_EXDI_DRIVER | El destino actual es un kernel activo conectado mediante controladores eXDI. |
| DEBUG_KERNEL_SMALL_DUMP | El destino actual es un archivo de volcado de memoria pequeño en modo kernel. |
| DEBUG_KERNEL_DUMP | El destino actual es un archivo de volcado de memoria de kernel en modo kernel. |
| DEBUG_KERNEL_FULL_DUMP | El destino actual es un archivo de volcado de memoria completo en modo kernel. |
Los siguientes valores son aplicables a los destinos en modo de usuario.
| Valor | Descripción |
|---|---|
| DEBUG_USER_WINDOWS_PROCESS | El destino actual es un proceso en modo de usuario en el mismo equipo que el motor del depurador. |
| DEBUG_USER_WINDOWS_PROCESS_SERVER | El destino actual es un proceso en modo de usuario conectado mediante un servidor de procesos. |
| DEBUG_USER_WINDOWS_SMALL_DUMP | El destino actual es un archivo Minidump en modo de usuario. |
| DEBUG_USER_WINDOWS_DUMP | El destino actual es un archivo de volcado de User-Mode completo. |
Valor devuelto
Este método no devuelve ningún valor.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Escritorio |
| Encabezado | dbgeng.h |