Compartir a través de

PAGP_COMMIT_VIRTUAL función de devolución de llamada (videoagp.h)

  • Artículo

La función AgpCommitVirtual asigna memoria virtual reservada a un intervalo asociado de direcciones físicas descodables de AGP.

Sintaxis

PAGP_COMMIT_VIRTUAL PagpCommitVirtual;

PVOID PagpCommitVirtual(
  [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. El identificador de contexto se obtuvo de AgpReserveVirtual.

[in] Pages

Especifica el número de páginas de memoria virtual que se van a asignar.

[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 virtuales reservado identificado por VirtualReserveContext.

Valor devuelto

AgpCommitVirtual devuelve la dirección virtual de la base de las páginas confirmadas si la asignación se realizó correctamente; de lo contrario, devuelve NULL.

Comentarios

Antes de llamar a AgpCommitVirtual para confirmar un intervalo de páginas virtuales, debe hacer lo siguiente:

Una vez completados estos elementos, puede llamar a AgpCommitVirtual para asignar una parte de las páginas virtuales reservadas a las páginas ya asignadas y bloqueadas por AgpCommitPhysical. No debe intentar asignar una página de direcciones virtuales si aún no se ha asignado la página correspondiente de direcciones físicas.

Los controladores de minipuerto de vídeo que se ejecutan en Microsoft Windows 2000 siempre deben confirmar un intervalo virtual cuyo tamaño es un múltiplo de 64 kilobytes. Si llama a AgpCommitVirtual para confirmar un intervalo virtual que no es un múltiplo de 64 kilobytes, puede devolver una dirección virtual no válida.

En Windows XP y versiones posteriores, AgpCommitVirtual expande automáticamente el intervalo confirmado para que sea un múltiplo de 64 kilobytes.

Cuando un controlador de minipuerto llama a AgpCommitVirtual, una parte del intervalo de direcciones virtuales identificado por VirtualReserveContext se asigna a direcciones físicas. La parte asignada comienza las páginas Offset en el intervalo de direcciones virtuales identificado por VirtualReserveContext.

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

Consulte también

AgpFreeVirtual

AgpReservePhysical

AgpReserveVirtual