Функция 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

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

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

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

Замечания

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

VideoPortLockPages нельзя вызывать из ISR или DPC.

Требования

См. также

VideoPortLockBuffer