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

La función AgpReserveVirtual reserva un intervalo de direcciones virtuales para AGP.

Sintaxis

PAGP_RESERVE_VIRTUAL PagpReserveVirtual;

PVOID PagpReserveVirtual(
  [in]  IN PVOID HwDeviceExtension,
  [in]  IN HANDLE ProcessHandle,
  [in]  IN PVOID PhysicalReserveContext,
  [out] OUT PVOID *VirtualReserveContext
)
{...}

Parámetros

[in] HwDeviceExtension

Puntero a la extensión del dispositivo del controlador de minipuerto.

[in] ProcessHandle

Identificador del proceso en el que se reserva el intervalo de direcciones virtuales. Si ProcessHandle es 0, el intervalo de direcciones virtuales se asigna en el espacio del sistema.

[in] PhysicalReserveContext

Es el identificador de contexto que identifica el intervalo de direcciones físicas reservado con el que se va a asociar la reserva de memoria virtual. Este contexto se obtuvo de AgpReservePhysical.

[out] VirtualReserveContext

Es la ubicación en la que el controlador de puerto de vídeo escribe un identificador de contexto que identifica la memoria virtual reservada.

Valor devuelto

AgpReserveVirtual devuelve la dirección base del intervalo de direcciones virtuales reservadas si se ejecuta correctamente; de lo contrario, devuelve NULL.

Observaciones

Si ProcessHandle no es 0, reserva AgpReserveVirtual, pero no confirma, un intervalo de direcciones virtuales en el espacio de direcciones de un proceso en modo de usuario. En ese caso, debe llamar a AgpCommitVirtual para asignar las direcciones virtuales reservadas (modo de usuario) a direcciones físicas.

Si processHandle es 0, AgpReserveVirtual asigna un intervalo de direcciones virtuales en el espacio del sistema y asigna automáticamente (confirma) todo el intervalo de direcciones virtuales a direcciones físicas. Aunque AgpReserveVirtual confirma todo el intervalo virtual, debe llamar a AgpCommitVirtual antes de que cualquier código acceda al intervalo virtual.

Al llamar a AgpReserveVirtual para asignar un intervalo de direcciones virtuales en el espacio del sistema (es decir, si establece ProcessHandle en 0), todo el intervalo de direcciones físicas identificadas por PhysicalReserveContext debe confirmarse en páginas bloqueadas de memoria física mediante una llamada anterior a AgpCommitPhysical.

El controlador de miniport puede llamar a AgpReleaseVirtual 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 AgpReleaseVirtual para liberar el intervalo de direcciones virtuales reservado cuando ya no sea necesario.

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

Consulte también

AgpCommitPhysical

AgpCommitVirtual

AgpReleaseVirtual

AgpReservePhysical