Metodo IDebugDataSpaces4::ReadPhysical2 (dbgeng.h)

Articolo
02/23/2024

Il metodo ReadPhysical2 legge la memoria della destinazione dall'indirizzo fisico specificato.

Sintassi

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

Parametri

[in] Offset

Specifica l'indirizzo fisico della memoria da leggere.

[in] Flags

Specifica le proprietà della memoria fisica da leggere. Deve corrispondere al modo in cui la memoria fisica è stata pubblicizzata al sistema operativo nella destinazione. I valori possibili sono elencati nella tabella seguente.

Valore	Descrizione
DEBUG_PHYSICAL_DEFAULT	Usare la memorizzazione nella cache di memoria predefinita.
DEBUG_PHYSICAL_CACHED	La memoria fisica viene memorizzata nella cache.
DEBUG_PHYSICAL_UNCACHED	La memoria fisica non è memorizzata nella cache.
DEBUG_PHYSICAL_WRITE_COMBINED	La memoria fisica è combinata in scrittura.

[out] Buffer

Riceve la memoria letta.

[in] BufferSize

Specifica le dimensioni, in byte, del buffer buffer del buffer. Si tratta del numero massimo di byte che verranno letti.

[out, optional] BytesRead

Riceve il numero di byte letti dalla memoria della destinazione. Se BytesRead è NULL, queste informazioni non vengono restituite.

Valore restituito

Codice restituito	Descrizione
S_OK	Il metodo è stato eseguito correttamente.

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

Commenti

Questo metodo è disponibile solo nel debug in modalità kernel.

I flag DEBUG_PHYSICAL_CACHED, DEBUG_PHYSICAL_UNCACHED e DEBUG_PHYSICAL_WRITE_COMBINED possono essere usati solo quando la destinazione è una destinazione del kernel live di cui viene eseguito il debug nel modo standard (usando una porta COM, un bus 1394 o una named pipe).