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

Artículo
08/07/2023

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 Space 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 Offset. Aquí es donde el motor del depurador lee la memoria de . El espacio debe establecerse en DEBUG_DATA_SPACE_VIRTUAL. Se devuelve un ULONG al búfer. Este 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 el 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. Esto 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 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 Which. Si El búfer es NULL, esta información no se devuelve.

[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, 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.

Requisitos

Requisito	Value
Plataforma de destino	Escritorio
Encabezado	dbgeng.h (include Dbgeng.h)

Compartir a través de