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 va a desasignación de memoria virtual.
Valor devuelto
Ninguno
Observaciones
Cuando un controlador de miniporta llama a AgpFreeVirtual, Páginas páginas de direcciones virtuales no están asignadas. El intervalo sin asignar comienza páginas de desplazamiento en el intervalo asociado con VirtualReserveContext. El controlador de miniport debe especificar que el desplazamiento exacto y el número de páginas se liberen tal como se confirmaron en una llamada anterior a AgpCommitVirtual.
Una llamada a AgpFreeVirtual debe emparejarse con una llamada anterior a AgpCommitVirtualy esa llamada a AgpCommitVirtual debe ir precedida de una llamada correcta a AgpReserveVirtual. Si se produce un error AgpReserveVirtual (devuelve NULL), no debe llamar a AgpCommitVirtual o AgpFreeVirtual.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Disponible en Windows 2000 y versiones posteriores de los sistemas operativos Windows. |
| de la plataforma de destino de | Escritorio |
| encabezado de | videoagp.h (incluya Video.h) |
| irQL | PASSIVE_LEVEL |