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

Artigo
02/23/2024

O método FillVirtual grava um padrão de bytes na memória virtual do destino. O padrão é gravado repetidamente até que o intervalo de memória especificado seja preenchido.

Sintaxe

HRESULT FillVirtual(
  [in]            ULONG64 Start,
  [in]            ULONG   Size,
  [in]            PVOID   Pattern,
  [in]            ULONG   PatternSize,
  [out, optional] PULONG  Filled
);

Parâmetros

[in] Start

Especifica o local no espaço de endereço virtual do destino no qual começar a gravar o padrão.

[in] Size

Especifica quantos bytes gravar na memória do destino.

[in] Pattern

Especifica o local de memória do padrão.

[in] PatternSize

Especifica o tamanho em bytes do padrão.

[out, optional] Filled

Recebe o número de bytes gravados. Se estiver definido como 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 grava o padrão na memória do destino tantas vezes quanto caberá em Bytes de tamanho .

Se a cópia final do padrão não se ajustar completamente ao intervalo de memória, ela só será parcialmente gravada. Isso inclui o caso em que o tamanho do padrão é maior que o valor de Size e os bytes extras no padrão são ignorados.