PAGP_COMMIT_PHYSICAL función de devolución de llamada (videoagp.h)
La función AgpCommitPhysical asigna memoria del sistema (físico) al intervalo especificado de direcciones físicas descodables de AGP.
Sintaxis
PAGP_COMMIT_PHYSICAL PagpCommitPhysical;
BOOLEAN PagpCommitPhysical(
[in] IN PVOID HwDeviceExtension,
[in] IN PVOID PhysicalReserveContext,
[in] IN ULONG Pages,
[in] IN ULONG Offset
)
{...}
Parámetros
[in] HwDeviceExtension
Puntero a la extensión del dispositivo del controlador de minipuerto.
[in] PhysicalReserveContext
Identifica un intervalo de direcciones físicas reservado. El identificador de contexto se obtiene de AgpReservePhysical.
[in] Pages
Especifica el número de páginas de memoria del sistema que se van a confirmar.
[in] Offset
Especifica el desplazamiento de página en el que se van a confirmar las páginas. El desplazamiento se aplica al intervalo de direcciones físicas reservado asociado a PhysicalReserveContext.
Valor devuelto
AgpCommitPhysical devuelve TRUE si la asignación se realizó correctamente y FALSE en caso contrario.
Comentarios
Un controlador de minipuerto de vídeo primero debe reservar direcciones físicas llamando a AgpReservePhysical antes de llamar a esta función.
No llame a AgpCommitPhysical para confirmar las direcciones que ya se han confirmado. Si el intervalo de páginas especificado por PhysicalReserveContext, Pages y Offset incluye las páginas confirmadas anteriormente, AgpCommitPhysical podría producir un error.
Los controladores de minipuerto de vídeo que se ejecutan en Microsoft Windows 2000 siempre deben reservar y confirmar un intervalo físico cuyo tamaño es un múltiplo de 64 kilobytes. Reservar o confirmar un intervalo físico que no sea múltiplo de 64 kilobytes puede dar lugar a que AgpReserveVirtual o AgpCommitVirtual devuelvan una dirección virtual no válida.
En Windows XP y versiones posteriores, AgpCommitPhysical expande automáticamente el intervalo confirmado para que sea un múltiplo de 64 kilobytes.
Cuando un controlador de minipuerto de vídeo llama a AgpCommitPhysical, una parte del intervalo de direcciones físico identificado por PhysicalReserveContext se asigna a páginas bloqueadas de memoria física. La parte asignada comienza las páginas Offset en el intervalo identificado por PhysicalReserveContext. El controlador de minipuerto de vídeo puede acceder a la memoria física confirmada como si fuera contiguo.
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 |