Compartilhar via


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

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).

Requisitos

Requisito Valor
Plataforma de Destino Área de Trabalho
Cabeçalho dbgeng.h (inclua Dbgeng.h)

Confira também

IDebugDataSpaces4

ReadPhysical

WritePhysical2