Función VideoPortCompleteDma (video.h)
La función VideoPortCompleteDma vacía los datos restantes en la memoria caché interna del adaptador de bus-master 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 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 de VP_SCATTER_GATHER_LIST que se pasó anteriormente a la rutina de devolución de llamada del controlador de miniporte, HwVidExecuteDma.
[in] WriteToDevice
Especifica la dirección de la transferencia DMA. Un valor de TRUE denota una transferencia del búfer al dispositivo y un valor de FALSE denota una transferencia del dispositivo al búfer.
Valor devuelto
videoPortCompleteDma devuelve NO_ERROR.
Observaciones
El controlador de miniporte de vídeo debe llamar a VideoPortCompleteDma inmediatamente para liberar recursos del sistema después de completar 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 | Valor |
|---|---|
| cliente mínimo admitido | Disponible en Windows XP y versiones posteriores de los sistemas operativos Windows. |
| de la plataforma de destino de | Escritorio |
| encabezado de | video.h (incluya Video.h) |
| biblioteca de | Videoprt.lib |
| DLL de | Videoprt.sys |
| irQL | <=DISPATCH_LEVEL |