Поделиться через

Функция VideoPortLockPages (video.h)

  • Статья

Функция VideoPortLockPagesустарела в Windows 2000 и более поздних версиях. Используйте VideoPortLockBuffer вместо этой функции.

VideoPortLockPages блокирует указанную виртуальную память и, возможно, выполняет часть или всю передачу DMA.

Синтаксис

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
);

Параметры

[in] HwDeviceExtension

Указатель на расширение устройства драйвера мини-порта.

[in, out] pVrp

Указатель на структуру VIDEO_REQUEST_PACKET . Драйвер мини-порта должен задать inputBuffer и InputBufferLength , чтобы он содержал виртуальный адрес и размер памяти в байтах, соответственно, заблокированной для передачи. Эта память была выделена драйвером дисплея и передана драйверу минипорта через IOCTL. Видеопорт возвращает указатель на и размер в байтах списка точечной и сборной в OutputBuffer и OutputBufferLength соответственно.

[in] pUEvent

Указатель на сопоставленное событие пользователя, которое должно быть задано драйвером мини-порта или значение NULL. Событие пользователя было сопоставлено драйвером дисплея и передано драйверу минипорта через IOCTL.

[in] pDisplayEvent

Указатель на событие, которое должно быть задано драйвером мини-порта или ЗНАЧЕНИЕ NULL. Это событие было создано и получено от драйвера дисплея через IOCTL.

[in] DmaFlags

Указывает действие, подлежащее выполнению. Этот параметр должен иметь одно из следующих значений:

Значение Значение
VideoPortDmaInitOnly VideoPortLockPages блокирует запрошенную память.
VideoPortKeepPagesLocked VideoPortLockPages не выполняет никаких действий.
VideoPortUnlockAfterDma VideoPortLockPages не выполняет никаких действий.

Возвращаемое значение

Функция VideoPortLockPages возвращает значение TRUE после успешного выполнения запрошенного действия. Если параметр DmaFlags не равен VideoPortDmaInitOnly, возвращается значение FALSE.

Комментарии

Сведения о передачах DMA на основе пакетов и общих буферов см. в разделе Bus-Master DMA в видеоДрайвере минипорта .

VideoPortLockPages не может вызываться из ISR или DPC.

Требования

Требование Значение
Минимальная версия клиента Доступно в Windows 2000 и более поздних версиях операционных систем Windows.
Целевая платформа Персональный компьютер
Верхняя часть video.h (включить Video.h)
Библиотека Videoprt.lib
DLL Videoprt.sys

См. также раздел

VideoPortLockBuffer