Função VideoPortCompleteDma (video.h)
A função VideoPortCompleteDma libera todos os dados restantes em um cache interno do adaptador master barramento no final de uma operação de transferência de DMA e libera os registros de mapa alocados anteriormente e a lista de dispersão/coleta usada em operações de dispersão/coleta de DMA.
Sintaxe
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
Ponteiro para a extensão de dispositivo do driver de miniport.
[in] VpDmaAdapter
Ponteiro para uma estrutura VP_DMA_ADAPTER que representa o adaptador master de barramento. Essa estrutura foi retornada por uma chamada para VideoPortGetDmaAdapter.
[in] VpScatterGather
Ponteiro para a estrutura de VP_SCATTER_GATHER_LIST passada anteriormente para a rotina de retorno de chamada do driver de miniport, HwVidExecuteDma.
[in] WriteToDevice
Especifica a direção da transferência de DMA. Um valor true denota uma transferência do buffer para o dispositivo e um valor false indica uma transferência do dispositivo para o buffer.
Retornar valor
VideoPortCompleteDma retorna NO_ERROR.
Comentários
O driver de miniporto de vídeo deve chamar VideoPortCompleteDma imediatamente para liberar recursos do sistema após a conclusão de uma transferência de DMA.
É importante observar que a lista de dispersão/coleta criada por VideoPortStartDma se torna inválida quando VideoPortCompleteDma é chamado..
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível no Windows XP e versões posteriores dos sistemas operacionais Windows. |
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | video.h (incluir Video.h) |
| Biblioteca | Videoprt.lib |
| DLL | Videoprt.sys |
| IRQL | <=DISPATCH_LEVEL |