VideoPortCompleteDma - NtDoc

Native API online documentation, based on the System Informer (formerly Process Hacker) phnt headers
// video.h

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
);
View the official Windows Driver Kit DDI reference

NtDoc

No description available.

Windows Driver Kit DDI reference (nf-video-videoportcompletedma)

VideoPortCompleteDma function

Description

The VideoPortCompleteDma function flushes any data remaining in a bus-master adapter's internal cache at the end of a DMA transfer operation, and then frees the previously allocated map registers and scatter/gather list used in scatter/gather DMA operations.

Parameters

HwDeviceExtension [in]

Pointer to the miniport driver's device extension.

VpDmaAdapter [in]

Pointer to a VP_DMA_ADAPTER structure that represents the bus-master adapter. This structure was returned by a call to VideoPortGetDmaAdapter.

VpScatterGather [in]

Pointer to the VP_SCATTER_GATHER_LIST structure previously passed to the miniport driver callback routine, HwVidExecuteDma.

WriteToDevice [in]

Specifies the direction of the DMA transfer. A value of TRUE denotes a transfer from the buffer to the device, and a value of FALSE denotes a transfer from the device to the buffer.

Return value

VideoPortCompleteDma returns NO_ERROR.

Remarks

The video miniport driver should call VideoPortCompleteDma immediately to free up system resources after a DMA transfer has been completed.

It is important to note that the scatter/gather list built by VideoPortStartDma becomes invalid when VideoPortCompleteDma is called..

See also

VP_DMA_ADAPTER

VP_SCATTER_GATHER_LIST

VideoPortGetDmaAdapter

VideoPortStartDma