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

Artículo
08/07/2023

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

Sintaxis

HRESULT GetModuleByOffset(
  [in]            ULONG64  Offset,
  [in]            ULONG    StartIndex,
  [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 se encuentra 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.

[out, optional] Index

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

[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, esta información no se devuelve.

Valor devuelto

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

Código devuelto	Descripción
S_OK	Método realizado correctamente.

Comentarios

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 superiores de StartIndex.

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