Metodo IDebugDataSpaces::ReadVirtual (dbgeng.h)

Articolo
02/06/2025

Il metodo ReadVirtual legge la memoria dallo spazio indirizzi virtuale della destinazione.

Sintassi

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

Parametri

[in] Offset

Specifica la posizione nello spazio indirizzi virtuale di destinazione da leggere.

[out] Buffer

Specifica il buffer in cui leggere la memoria.

[in] BufferSize

Specifica le dimensioni in byte del buffer. Si tratta anche del numero di byte richiesti.

[out, optional] BytesRead

Riceve il numero di byte letti. Se è impostato su NULL, queste informazioni non vengono restituite.

Valore restituito

Codice restituito	Descrizione
S_OK	Il metodo ha avuto esito positivo. È possibile che byteRead sia minore di BufferSize, ma è stato restituito almeno un byte di dati.

Questo metodo può anche restituire valori di errore. Per altri dettagli, vedere valori restituiti.

Osservazioni

Questo metodo riempie il buffer con il contenuto della memoria nello spazio indirizzi virtuale della destinazione.

Questo metodo può fare riferimento a una cache di dati di memoria durante il recupero dei dati. Se i dati sono volatili, ad esempio lo stato hardware mappato alla memoria, usare ReadVirtualUncached.

Durante la lettura della memoria che contiene puntatori, questi puntatori sono per lo spazio indirizzi virtuale della destinazione e non per il motore. Ad esempio, se una struttura di dati contiene una stringa, potrebbe essere necessaria una seconda chiamata a questo metodo per leggere il contenuto della stringa.