PEXECUTE_DMA función de devolución de llamada (video.h)
HwVidExecuteDma es una rutina de devolución de llamada implementada por el controlador de minipuerto que es responsable de recuperar pares físicos de dirección/longitud de una lista de dispersión y recopilación, y para programar el hardware para iniciar la transferencia de DMA real.
Sintaxis
PEXECUTE_DMA PexecuteDma;
void PexecuteDma(
PVOID HwDeviceExtension,
PVP_DMA_ADAPTER VpDmaAdapter,
PVP_SCATTER_GATHER_LIST SGList,
PVOID Context
)
{...}
Parámetros
HwDeviceExtension
Puntero al área de almacenamiento por adaptador del controlador miniporte. Para obtener más información, consulte Extensiones de dispositivo.
VpDmaAdapter
Puntero a la estructura VP_DMA_ADAPTER que representa el adaptador bus-master. Esta estructura se devolvió mediante una llamada a VideoPortGetDmaAdapter.
SGList
Puntero a una estructura de VP_SCATTER_GATHER_LIST . El controlador de puerto de vídeo rellena la información de esta estructura y pasa esta estructura al controlador de minipuerto.
Context
Puntero al contexto determinado por el controlador pasado desde VideoPortStartDma.
Valor devuelto
None
Observaciones
Esta función está disponible en Windows XP y versiones posteriores.
Si el controlador de minipuerto informa de que el dispositivo no admite dispersión o recopilación, solo habrá un único elemento en la lista de dispersión y recopilación que se pasa a esta rutina. La lista de dispersión y recopilación es válida hasta que se llama a VideoPortCompleteDma .
La última tarea que realiza la función VideoPortStartDma del controlador de puerto de vídeo es llamar a la rutina de devolución de llamada HwVidExecuteDma del controlador de miniporte. Se trata de esta devolución de llamada que lleva a cabo realmente la operación de transferencia de DMA.
HwVidExecuteDma debe estar en memoria no paginada y no debe tener acceso a ningún código o datos paginables.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Escritorio |
| Encabezado | video.h (incluir Video.h) |