Função VideoPortCompleteDma (video.h)
A função VideoPortCompleteDma libera todos os dados restantes no cache interno de um adaptador mestre de 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 DMA de dispersão/coleta.
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 do dispositivo do driver de miniport.
[in] VpDmaAdapter
Ponteiro para uma estrutura de VP_DMA_ADAPTER que representa o adaptador mestre do 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 miniporto, HwVidExecuteDma .
[in] WriteToDevice
Especifica a direção da transferência de DMA. Um valor de VERDADEIRO indica uma transferência do buffer para o dispositivo e um valor de FALSE indica uma transferência do dispositivo para o buffer.
Valor de retorno
VideoPortCompleteDma retorna NO_ERROR.
Observações
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 pelo VideoPortStartDma torna-se inválida quando VideoPortCompleteDma é chamado..
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Disponível no Windows XP e versões posteriores dos sistemas operacionais Windows. |
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | video.h (inclua Video.h) |
| biblioteca | Videoprt.lib |
| de DLL | Videoprt.sys |
| IRQL | <=DISPATCH_LEVEL |