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 |