Funzione VideoPortCompleteDma (video.h)
La funzione VideoPortCompleteDma scarica tutti i dati rimanenti nella cache interna di un adattatore bus alla fine di un'operazione di trasferimento DMA e quindi libera i registri mappa allocati in precedenza e l'elenco di dispersione/raccolta usati nelle operazioni DMA a dispersione/raccolta.
Sintassi
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
);
Parametri
[in] HwDeviceExtension
Puntatore all'estensione del dispositivo del driver miniport.
[in] VpDmaAdapter
Puntatore a una struttura VP_DMA_ADAPTER che rappresenta l'adattatore bus-master. Questa struttura è stata restituita da una chiamata a VideoPortGetDmaAdapter.
[in] VpScatterGather
Puntatore alla struttura VP_SCATTER_GATHER_LIST passata in precedenza alla routine di callback del driver miniport , HwVidExecuteDma.
[in] WriteToDevice
Specifica la direzione del trasferimento DMA. Un valore TRUE indica un trasferimento dal buffer al dispositivo e un valore FALSE indica un trasferimento dal dispositivo al buffer.
Valore restituito
VideoPortCompleteDma restituisce NO_ERROR.
Commenti
Il driver miniport video deve chiamare immediatamente VideoPortCompleteDma per liberare le risorse di sistema dopo il completamento di un trasferimento DMA.
È importante notare che l'elenco a dispersione/raccolta compilato da VideoPortStartDma diventa non valido quando viene chiamato VideoPortCompleteDma .
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile in Windows XP e versioni successive dei sistemi operativi Windows. |
| Piattaforma di destinazione | Desktop |
| Intestazione | video.h (include Video.h) |
| Libreria | Videoprt.lib |
| DLL | Videoprt.sys |
| IRQL | <=DISPATCH_LEVEL |