Método IDebugDataSpaces::ReadVirtual (dbgeng.h)

Artículo
02/26/2024

El método ReadVirtual lee la memoria del espacio de direcciones virtuales del destino.

Sintaxis

HRESULT ReadVirtual(
  [in]            ULONG64 Offset,
  [out]           PVOID   Buffer,
  [in]            ULONG   BufferSize,
  [out, optional] PULONG  BytesRead
);

Parámetros

[in] Offset

Especifica la ubicación en el espacio de direcciones virtuales del destino que se va a leer.

[out] Buffer

Especifica el búfer en el que se va a leer la memoria.

[in] BufferSize

Especifica el tamaño en bytes del búfer. También es el número de bytes que se solicitan.

[out, optional] BytesRead

Recibe el número de bytes leídos. Si se establece en NULL, esta información no se devuelve.

Valor devuelto

Código devuelto	Descripción
S_OK	Método realizado correctamente. Es posible que BytesRead sea menor que BufferSize, pero se devolvió al menos un byte de datos.

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

Comentarios

Este método rellena el búfer con el contenido de la memoria en el espacio de direcciones virtuales del destino.

Este método puede hacer referencia a una memoria caché de datos de memoria al recuperar datos. Si los datos son volátiles, como el estado de hardware asignado a memoria, use ReadVirtualUncached en su lugar.

Al leer la memoria que contiene punteros, estos punteros son para el espacio de direcciones virtuales del destino y no para el del motor. Por ejemplo, si una estructura de datos contenía una cadena, es posible que se necesite una segunda llamada a este método para leer el contenido de la cadena.