función de devolución de llamada PEXECUTE_DMA (video.h)
HwVidExecuteDma es una rutina de devolución de llamada implementada por el controlador de miniporte que es responsable de recuperar pares físicos de dirección y longitud de una lista de dispersión y recopilación, y para programar el hardware para iniciar la transferencia 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 de miniporte. Para obtener más información, consulte extensiones de dispositivo.
VpDmaAdapter
Puntero a la estructura VP_DMA_ADAPTER que representa el adaptador de bus-master. Esta estructura se devolvió mediante una llamada a VideoPortGetDmaAdapter.
SGList
Puntero a una estructura 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 miniport.
Context
Puntero al contexto determinado por el controlador pasado desde VideoPortStartDma.
Valor devuelto
Ninguno
Observaciones
Esta función está disponible en Windows XP y versiones posteriores.
Si el controlador de miniporte informa de que el dispositivo no admite dispersión o recopilación, solo habrá un solo elemento en la lista de dispersión o 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 del controlador de puerto de vídeo VideoPortStartDma es llamar a la rutina de devolución de llamada del controlador de miniporte HwVidExecuteDma. Es esta devolución de llamada que realmente lleva a cabo la operación de transferencia DMA.
HwVidExecuteDma debe estar en memoria no paginada y no debe tener acceso a ningún código o datos paginables.
Requisitos
| Requisito | Valor |
|---|---|
| de la plataforma de destino de | Escritorio |
| encabezado de | video.h (incluya Video.h) |