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

Artigo
02/23/2024

O método ReadPhysical2 lê a memória do destino do endereço físico especificado.

Sintaxe

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

Parâmetros

[in] Offset

Especifica o endereço físico da memória a ser lida.

[in] Flags

Especifica as propriedades da memória física a ser lida. Isso deve corresponder à maneira como a memória física foi anunciada para o sistema operacional no destino. Os valores possíveis são listados na tabela a seguir.

Valor	Descrição
DEBUG_PHYSICAL_DEFAULT	Use o cache de memória padrão.
DEBUG_PHYSICAL_CACHED	A memória física é armazenada em cache.
DEBUG_PHYSICAL_UNCACHED	A memória física não está em cache.
DEBUG_PHYSICAL_WRITE_COMBINED	A memória física é combinada por gravação.

[out] Buffer

Recebe a memória lida.

[in] BufferSize

Especifica o tamanho, em bytes, do buffer de buffer . Esse é o número máximo de bytes que serão lidos.

[out, optional] BytesRead

Recebe o número de bytes lidos da memória do destino. Se BytesRead for NULL, essas informações não serão retornadas.

Retornar valor

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.

Esse método também pode retornar valores de erro. Consulte Valores retornados para obter mais detalhes.

Comentários

Esse método só está disponível na depuração no modo kernel.

Os sinalizadores DEBUG_PHYSICAL_CACHED, DEBUG_PHYSICAL_UNCACHED e DEBUG_PHYSICAL_WRITE_COMBINED só podem ser usados quando o destino é um destino de kernel dinâmico que está sendo depurado da maneira padrão (usando uma porta COM, um barramento 1394 ou um pipe nomeado).