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)

Consulte también

VP_DMA_ADAPTER

VP_SCATTER_GATHER_LIST

VideoPortCompleteDma

VideoPortGetDmaAdapter

VideoPortStartDma