Compartilhar via


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

O método WritePhysical2 grava dados no endereço físico especificado na memória do destino.

Sintaxe

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

Parâmetros

[in] Offset

Especifica o endereço físico da memória na qual gravar os dados.

[in] Flags

Especifica as propriedades da memória física a ser gravada. 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.

[in] Buffer

Especifica os dados a serem gravados.

[in] BufferSize

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

[out, optional] BytesWritten

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

Retornar valor

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

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

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

WritePhysical

WritePhysical2