Функция VideoPortCompleteDma (video.h)
Функция VideoPortCompleteDma очищает все данные, оставшиеся во внутреннем кэше адаптера шины главного адаптера в конце операции передачи 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, представляющую главный адаптер шины. Эта структура была возвращена вызовом VideoPortGetDmaAdapter.
[in] VpScatterGather
Указатель на структуру VP_SCATTER_GATHER_LIST, переданную ранее в подпрограмму обратного вызова драйвера минипорта, HwVidExecuteDma.
[in] WriteToDevice
Указывает направление передачи DMA. Значение TRUE обозначает передачу из буфера на устройство, а значение FALSE обозначает передачу с устройства на буфер.
Возвращаемое значение
VideoPortCompleteDma возвращает NO_ERROR.
Замечания
Драйвер видеопорта должен вызывать VideoPortCompleteDma немедленно, чтобы освободить системные ресурсы после завершения передачи DMA.
Важно отметить, что список точек и сбора, созданный VideoPortStartDma, становится недопустимым при вызове VideoPortCompleteDma.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Доступно в Windows XP и более поздних версиях операционных систем Windows. |
| целевая платформа | Настольный |
| заголовка | video.h (include Video.h) |
| библиотеки | Videoprt.lib |
| DLL | Videoprt.sys |
| IRQL | <=DISPATCH_LEVEL |