PAGP_RESERVE_PHYSICAL función de devolución de llamada (videoagp.h)
La función
Sintaxis
PAGP_RESERVE_PHYSICAL PagpReservePhysical;
PHYSICAL_ADDRESS PagpReservePhysical(
[in] IN PVOID HwDeviceExtension,
[in] IN ULONG Pages,
[in] IN VIDEO_PORT_CACHE_TYPE Caching,
[out] OUT PVOID *PhysicalReserveContext
)
{...}
Parámetros
[in] HwDeviceExtension
Puntero a la extensión del dispositivo del controlador de minipuerto.
[in] Pages
Especifica el número de páginas que debe reservar el controlador de puerto de vídeo.
[in] Caching
Enumeración VIDEO_PORT_CACHE_TYPE que especifica el tipo de almacenamiento en caché que debe usar el sistema.
[out] PhysicalReserveContext
Especifica la ubicación en la que el controlador de puerto de vídeo escribe un identificador de contexto que identifica el espacio de direcciones físicas reservado.
Valor devuelto
AgpReservePhysical devuelve la dirección base del intervalo de direcciones físicas reservada si se ejecuta correctamente; de lo contrario, devuelve NULL.
Observaciones
Los controladores de minipuerto de vídeo que se ejecutan en Windows 2000 siempre deben reservar un intervalo cuyo tamaño sea un múltiplo de 64 kilobytes. Reservar un intervalo 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, AgpReservePhysical expande automáticamente el intervalo solicitado a un múltiplo de 64 kilobytes.
Tras la devolución correcta, el controlador AGP puede responder al intervalo de direcciones físicas reservado en el bus. Sin embargo, el controlador de minipuerto de vídeo primero debe llamar a AgpCommitPhysical para que esta memoria se confirme antes de acceder a ella para que se definan los resultados a los que se accede.
El controlador de miniport puede llamar a AgpReservePhysical varias veces para reservar muchos intervalos de direcciones más pequeños en lugar de un intervalo grande.
El controlador de miniport debe llamar a AgpReleasePhysical para liberar el intervalo de direcciones físicos cuando ya no sea necesario.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows 2000 |
| de la plataforma de destino de |
Escritorio |
| encabezado de |
videoagp.h (incluya Video.h) |
| irQL | PASSIVE_LEVEL |