Metodo IDebugDataSpaces3::ReadVirtual (dbgeng.h)

Articolo
02/23/2024

Il metodo ReadVirtual legge la memoria dallo spazio indirizzi virtuale di 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 della 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 è stato eseguito correttamente. È possibile che BytesRead sia minore di BufferSize, ma almeno un byte di dati è stato restituito.

Questo metodo può anche restituire valori di errore. Per altre informazioni, vedere Valori restituiti .

Commenti

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 invece ReadVirtualUncached .

Quando si legge memoria contenente 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.