Función VideoPortLockPages (video.h)

La función VideoPortLockPages está obsoleta en Windows 2000 y versiones posteriores. Use VideoPortLockBuffer en lugar de esta función.

VideoPortLockPages bloquea la memoria virtual especificada y, posiblemente, realiza parte o toda una transferencia DMA.

Sintaxis

VIDEOPORT_DEPRECATED VIDEOPORT_API BOOLEAN VideoPortLockPages(
  [in]      IN PVOID                     HwDeviceExtension,
  [in, out] IN OUT PVIDEO_REQUEST_PACKET pVrp,
  [in]      IN PEVENT                    pUEvent,
  [in]      IN PEVENT                    pDisplayEvent,
  [in]      IN DMA_FLAGS                 DmaFlags
);

Parámetros

[in] HwDeviceExtension

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

[in, out] pVrp

Puntero a una estructura de VIDEO_REQUEST_PACKET . El controlador de minipuerto debe haber establecido InputBuffer y InputBufferLength para que contenga la dirección virtual y el tamaño en bytes, respectivamente, de la memoria que se va a bloquear para la transferencia. El controlador de pantalla asignó esta memoria y se pasó al controlador de minipuerto a través de un IOCTL. El puerto de vídeo devuelve un puntero a y el tamaño en bytes de la lista de dispersión/recopilación en OutputBuffer y OutputBufferLength, respectivamente.

[in] pUEvent

Puntero a un evento de usuario asignado que el controlador de miniporte va a establecer o NULL. El controlador de pantalla asignó el evento de usuario y se pasó al controlador de minipuerto a través de un IOCTL.

[in] pDisplayEvent

Puntero a un evento que el controlador de miniporte va a establecer o NULL. Este evento lo creó y recibió del controlador de pantalla a través de un IOCTL.

[in] DmaFlags

Especifica la acción que se va a realizar. Este parámetro debe ser uno de los siguientes valores:

Valor devuelto

VideoPortLockPages devuelve TRUE tras completar correctamente la acción solicitada. Devuelve FALSE si el parámetro DmaFlags no es igual a VideoPortDmaInitOnly.

Comentarios

Consulte Bus-Master DMA in Video Miniport Drivers para obtener información sobre las transferencias DMA de búfer común y basadas en paquetes.

No se puede llamar a VideoPortLockPages desde un ISR o DPC.

Requisitos

Consulte también

VideoPortLockBuffer