Compartir a través de

Método IDebugSymbols3::GetModuleByOffset2 (dbgeng.h)

  • Artículo

El método GetModuleByOffset2 busca en los módulos del proceso para uno cuya asignación de memoria incluya la ubicación especificada.

Sintaxis

HRESULT GetModuleByOffset2(
  [in]            ULONG64  Offset,
  [in]            ULONG    StartIndex,
  [in]            ULONG    Flags,
  [out, optional] PULONG   Index,
  [out, optional] PULONG64 Base
);

Parámetros

[in] Offset

Especifica una ubicación en el espacio de direcciones virtuales del destino que está dentro de la asignación de memoria del módulo deseado; por ejemplo, la dirección de un símbolo que pertenece al módulo.

[in] StartIndex

Especifica el índice desde el que empezar a buscar.

[in] Flags

Especifica un conjunto de bits que contiene opciones que se usan al buscar el módulo con la ubicación especificada. Marcas puede contener las marcas de bits siguientes:

Bandera Efecto
DEBUG_GETMOD_NO_LOADED_MODULES No busque los módulos cargados.
DEBUG_GETMOD_NO_UNLOADED_MODULES No busque los módulos descargados.

[out, optional] Index

Recibe el índice del módulo. Si index es NULL, no se devuelve esta información.

[out, optional] Base

Recibe la ubicación en el espacio de direcciones de memoria del destino de la base del módulo. Si base es NULL, no se devuelve esta información.

Valor devuelto

Este método también puede devolver valores de error. Consulte valores devueltos para obtener más información.

Código devuelto Descripción
S_OK
 El método se realizó correctamente.

Observaciones

A partir del índice especificado, este método devuelve el primer módulo que encuentra cuyo intervalo de direcciones de asignación de memoria incluye la ubicación especificada. Si el destino tiene más de un módulo cuyo intervalo de direcciones de memoria incluye esta ubicación, se pueden encontrar módulos posteriores mediante llamadas repetidas a este método con valores más altos de StartIndex.

Para obtener más información sobre los módulos, consulte Modules.

Requisitos

Requisito Valor
de la plataforma de destino de Escritorio
encabezado de dbgeng.h (include Dbgeng.h)

Consulte también

GetModuleByIndex

GetModuleByOffset

IDebugSymbols3