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 | Significado |
|---|---|
| VideoPortDmaInitOnly | VideoPortLockPages bloquea la memoria solicitada. |
| VideoPortKeepPagesLocked | VideoPortLockPages no realiza ninguna acción. |
| VideoPortUnlockAfterDma | VideoPortLockPages no realiza ninguna acción. |
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
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible en Windows 2000 y versiones posteriores de los sistemas operativos Windows. |
| Plataforma de destino | Escritorio |
| Encabezado | video.h (incluya Video.h) |
| Library | Videoprt.lib |
| Archivo DLL | Videoprt.sys |