PAGP_FREE_VIRTUAL función de devolución de llamada (videoagp.h)
La función AgpFreeVirtual libera memoria virtual confirmada por una llamada anterior a AgpCommitVirtual.
Sintaxis
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
Puntero a la extensión del dispositivo del controlador de minipuerto.
[in] VirtualReserveContext
Identifica un intervalo de direcciones virtuales reservado. Este identificador de contexto se obtuvo de AgpReserveVirtual.
[in] Pages
Especifica el número de páginas de memoria virtual que el controlador de puerto de vídeo debe desasignación.
[in] Offset
Especifica el desplazamiento de página en el intervalo de direcciones virtuales reservado identificado por VirtualReserveContext que indica la dirección base real en la que se desasignación de memoria virtual.
Valor devuelto
None
Observaciones
Cuando un controlador de minipuerto llama a AgpFreeVirtual, no se asignan páginas de páginas de direcciones virtuales. El intervalo no asignado comienza las páginas Offset en el intervalo asociado a VirtualReserveContext. El controlador de minipuerto debe especificar que el desplazamiento exacto y el número de páginas se liberen como se confirmaron en una llamada anterior a AgpCommitVirtual.
Una llamada a AgpFreeVirtual debe estar emparejada con una llamada anterior a AgpCommitVirtual y esa llamada a AgpCommitVirtual debe ir precedida de una llamada correcta a AgpReserveVirtual. Si se produce un error en AgpReserveVirtual (devuelve NULL), no debe llamar a AgpCommitVirtual o AgpFreeVirtual.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible en Windows 2000 y versiones posteriores de los sistemas operativos Windows. |
| Plataforma de destino | Escritorio |
| Encabezado | videoagp.h (incluir Video.h) |
| IRQL | PASSIVE_LEVEL |