PAGP_FREE_VIRTUAL função de retorno de chamada (videoagp.h)

Artigo
02/07/2025

A função AgpFreeVirtual libera a memória virtual confirmada por uma chamada anterior para AgpCommitVirtual.

Sintaxe

PAGP_FREE_VIRTUAL PagpFreeVirtual;

void PagpFreeVirtual(
  [in] IN PVOID HwDeviceExtension,
  [in] IN PVOID VirtualReserveContext,
  [in] IN ULONG Pages,
  [in] IN ULONG Offset
)
{...}

Parâmetros

[in] HwDeviceExtension

Ponteiro para a extensão do dispositivo do driver de miniport.

[in] VirtualReserveContext

Identifica um intervalo de endereços virtuais reservado. Esse identificador de contexto foi obtido de AgpReserveVirtual.

[in] Pages

Especifica o número de páginas de memória virtual que o driver de porta de vídeo deve cancelar o mapa.

[in] Offset

Especifica o deslocamento de página para o intervalo de endereços virtuais reservado identificado por VirtualReserveContext que indica o endereço base real no qual desmaeça a memória virtual.

Valor de retorno

Nenhum

Observações

Quando um driver de miniporto chama AgpFreeVirtual, Páginas páginas de endereços virtuais não são mapeadas. O intervalo não mapeado começa páginas de deslocamento no intervalo associado a VirtualReserveContext. O driver de miniporto deve especificar que o deslocamento exato e o número de páginas sejam liberados conforme foram confirmados em uma chamada anterior para AgpCommitVirtual.

Uma chamada para AgpFreeVirtual deve ser emparelhada com uma chamada anterior para AgpCommitVirtual e essa chamada para AgpCommitVirtual deve ser precedida por uma chamada bem-sucedida para AgpReserveVirtual. Se AgpReserveVirtual falhar (retornará NULL), não será necessário chamar AgpCommitVirtual ou AgpFreeVirtual .

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Disponível no Windows 2000 e versões posteriores dos sistemas operacionais Windows.
da Plataforma de Destino	Área de trabalho
cabeçalho	videoagp.h (inclua Video.h)
IRQL	PASSIVE_LEVEL

Consulte também

AgpCommitVirtual

Partilhar via