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