Método IDebugDataSpaces4::GetOffsetInformation (dbgeng.h)

Artículo
02/06/2025

El método GetOffsetInformation proporciona información general sobre una dirección en el espacio de datos de un proceso.

Sintaxis

HRESULT GetOffsetInformation(
  [in]            ULONG   Space,
  [in]            ULONG   Which,
  [in]            ULONG64 Offset,
  [out, optional] PVOID   Buffer,
  [in]            ULONG   BufferSize,
  [out, optional] PULONG  InfoSize
);

Parámetros

[in] Space

Especifica el espacio de datos al que se aplica el parámetro offset . Los valores permitidos dependen del parámetro Which.

[in] Which

Especifica qué información sobre los datos se consultan. Esto determina los valores posibles para Espacio y el tipo de los datos devueltos en Buffer. Los valores posibles son:

DEBUG_OFFSINFO_VIRTUAL_SOURCE

Devuelve el origen de la memoria virtual del destino en Desplazamiento. Aquí es donde el motor del depurador lee la memoria de . espacio debe establecerse en DEBUG_DATA_SPACE_VIRTUAL. Se devuelve un ULONG a buffer. Esta ULONG puede tomar los valores enumerados en la tabla siguiente.

Valor	Descripción
DEBUG_VSOURCE_INVALID	El desplazamiento desplazamiento no está disponible en el espacio de direcciones virtuales del proceso. Esto podría significar que la dirección no es válida o que la memoria no está disponible, por ejemplo, un archivo de volcado de memoria podría no contener toda la memoria para el proceso o para el kernel.
DEBUG_VSOURCE_DEBUGGEE	El destino proporciona la memoria virtual en desplazamiento desplazamiento.
DEBUG_VSOURCE_MAPPED_IMAGE	El motor del depurador lee la memoria virtual del destino en desplazamiento desplazamiento desde un archivo de imagen local. Este suele ser el caso en los archivos minivolcados en los que las imágenes del módulo no se incluyen en el archivo de volcado de memoria y, en su lugar, se cargan mediante el motor del depurador.

[in] Offset

Especifica el desplazamiento en el espacio de datos del destino para el que se devuelve la información.

[out, optional] Buffer

Especifica el búfer para recibir la información. El tipo de los datos devueltos depende del valor de Que. Si de búfer es NULL, no se devuelve esta información.

[in] BufferSize

Especifica el tamaño, en bytes, del búfer de búfer.

[out, optional] InfoSize

Recibe el tamaño, en bytes, de la información que se devuelve. Si infoSize 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.

Requisitos

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

Compartir a través de