Función VideoPortCompleteDma (video.h)
La función VideoPortCompleteDma vacía los datos restantes en la memoria caché interna de un adaptador de bus maestro al final de una operación de transferencia DMA y, a continuación, libera los registros de mapa asignados previamente y la lista de dispersión/recopilación usadas en las operaciones de dispersión y recopilación de DMA.
Sintaxis
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
);
Parámetros
[in] HwDeviceExtension
Puntero a la extensión del dispositivo del controlador de minipuerto.
[in] VpDmaAdapter
Puntero a una estructura de VP_DMA_ADAPTER que representa el adaptador de bus-master. Esta estructura se devolvió mediante una llamada a VideoPortGetDmaAdapter.
[in] VpScatterGather
Puntero a la estructura VP_SCATTER_GATHER_LIST que se pasó anteriormente a la rutina de devolución de llamada del controlador de miniport, HwVidExecuteDma.
[in] WriteToDevice
Especifica la dirección de la transferencia DMA. Un valor de TRUE denota una transferencia desde el búfer al dispositivo y un valor de FALSE denota una transferencia desde el dispositivo al búfer.
Valor devuelto
VideoPortCompleteDma devuelve NO_ERROR.
Comentarios
El controlador de minipuerto de vídeo debe llamar inmediatamente a VideoPortCompleteDma para liberar recursos del sistema una vez completada una transferencia DMA.
Es importante tener en cuenta que la lista de dispersión y recopilación compilada por VideoPortStartDma deja de ser válida cuando se llama a VideoPortCompleteDma .
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible en Windows XP y versiones posteriores de los sistemas operativos Windows. |
| Plataforma de destino | Escritorio |
| Encabezado | video.h (incluya Video.h) |
| Library | Videoprt.lib |
| Archivo DLL | Videoprt.sys |
| IRQL | <=DISPATCH_LEVEL |