PAGP_COMMIT_PHYSICAL función de devolución de llamada (videoagp.h)
El 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 miniport.
[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 de lo contrario.
Observaciones
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, Pagesy Offset incluye las páginas confirmadas anteriormente, AgpCommitPhysical podría producir un error.
Los controladores de miniporte 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 un múltiplo de 64 kilobytes puede dar lugar a AgpReserveVirtual o AgpCommitVirtual devolver 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 miniporte 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 páginas offset en el intervalo identificado por PhysicalReserveContext. El controlador de miniporte de vídeo puede acceder a la memoria física confirmada como si fuera contigua.
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 |