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

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 de 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 da 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 remover o mapa da memória virtual.

Retornar valor

Nenhum

Comentários

Quando um driver de miniporto chama AgpFreeVirtual, páginas de páginas de endereços virtuais são não mapeadas. O intervalo não mapeado inicia 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 a 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), você não deverá chamar AgpCommitVirtual ou AgpFreeVirtual.

Requisitos

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

Confira também

AgpCommitVirtual