funzione di callback PEXECUTE_DMA (video.h)
HwVidExecuteDma è una routine di callback implementata dal driver miniport responsabile del recupero di coppie di indirizzi/lunghezze fisiche da un elenco di dispersione/raccolta e per la programmazione dell'hardware per avviare il trasferimento DMA effettivo.
Sintassi
PEXECUTE_DMA PexecuteDma;
void PexecuteDma(
PVOID HwDeviceExtension,
PVP_DMA_ADAPTER VpDmaAdapter,
PVP_SCATTER_GATHER_LIST SGList,
PVOID Context
)
{...}
Parametri
HwDeviceExtension
Puntatore all'area di archiviazione per scheda del driver miniport. Per altre informazioni, vedere Estensioni del dispositivo.
VpDmaAdapter
Puntatore alla struttura VP_DMA_ADAPTER che rappresenta l'adattatore bus-master. Questa struttura è stata restituita da una chiamata a VideoPortGetDmaAdapter.
SGList
Puntatore a una struttura VP_SCATTER_GATHER_LIST . Il driver della porta video inserisce le informazioni in questa struttura e passa questa struttura al driver miniport.
Context
Puntatore al contesto determinato dal driver passato da VideoPortStartDma.
Valore restituito
nessuno
Osservazioni
Questa funzione è disponibile in Windows XP e versioni successive.
Se il driver miniport segnala che il dispositivo non supporta la raccolta/dispersione, sarà presente un solo elemento nell'elenco di dispersione/raccolta passato a questa routine. L'elenco a dispersione/raccolta è valido fino a quando non viene chiamato VideoPortCompleteDma .
L'ultima attività eseguita dalla funzione VideoPortStartDma del driver della porta video consiste nel chiamare la routine di callback HwVidExecuteDma del driver miniport. Si tratta di questo callback che esegue effettivamente l'operazione di trasferimento DMA.
HwVidExecuteDma deve trovarsi in memoria non in pagine e non deve accedere a codice o dati di paging.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Desktop |
| Intestazione | video.h (include Video.h) |