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

  • Статья

Функция VideoPortCompleteDma сбрасывает все данные, оставшиеся во внутреннем кэше адаптера master шины, в конце операции передачи DMA, а затем освобождает ранее выделенные регистры карт и список точечной и сборной, используемые в операциях DMA точечной и сборной.

Синтаксис

VIDEOPORT_DEPRECATED VIDEOPORT_API VP_STATUS VideoPortCompleteDma(
  [in] IN PVOID                   HwDeviceExtension,
  [in] IN PVP_DMA_ADAPTER         VpDmaAdapter,
  [in] IN PVP_SCATTER_GATHER_LIST VpScatterGather,
  [in] IN BOOLEAN                 WriteToDevice
);

Параметры

[in] HwDeviceExtension

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

[in] VpDmaAdapter

Указатель на структуру VP_DMA_ADAPTER, представляющую адаптер master шины. Эта структура была возвращена вызовом VideoPortGetDmaAdapter.

[in] VpScatterGather

Указатель на структуру VP_SCATTER_GATHER_LIST , переданную ранее в подпрограмму обратного вызова драйвера мини-порта HwVidExecuteDma.

[in] WriteToDevice

Указывает направление передачи DMA. Значение TRUE обозначает передачу из буфера на устройство, а значение FALSE — передачу из устройства в буфер.

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

VideoPortCompleteDma возвращает NO_ERROR.

Комментарии

Драйвер видео минипорта должен немедленно вызвать VideoPortCompleteDma , чтобы освободить системные ресурсы после завершения передачи DMA.

Важно отметить, что при вызове VideoPortCompleteDma становится недопустимым список точечной и сборной .

Требования

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

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

VP_DMA_ADAPTER

VP_SCATTER_GATHER_LIST

VideoPortGetDmaAdapter

VideoPortStartDma