função de retorno de chamada PEXECUTE_DMA (video.h)
HwVidExecuteDma é uma rotina de retorno de chamada implementada pelo driver de miniport que é responsável por recuperar pares de endereço físico/comprimento de uma lista de dispersão/coleta e por programar o hardware para iniciar a transferência de DMA real.
Sintaxe
PEXECUTE_DMA PexecuteDma;
void PexecuteDma(
PVOID HwDeviceExtension,
PVP_DMA_ADAPTER VpDmaAdapter,
PVP_SCATTER_GATHER_LIST SGList,
PVOID Context
)
{...}
Parâmetros
HwDeviceExtension
Ponteiro para a área de armazenamento por adaptador do driver de miniport. Para obter mais informações, consulte Extensões de dispositivo.
VpDmaAdapter
Ponteiro para a estrutura VP_DMA_ADAPTER que representa o adaptador de master de barramento. Essa estrutura foi retornada por uma chamada para VideoPortGetDmaAdapter.
SGList
Ponteiro para uma estrutura de VP_SCATTER_GATHER_LIST . O driver da porta de vídeo preenche as informações nessa estrutura e passa essa estrutura para o driver de miniporte.
Context
Ponteiro para o contexto determinado pelo driver passado de VideoPortStartDma.
Retornar valor
Nenhum
Comentários
Essa função está disponível no Windows XP e posterior.
Se o driver de miniporto relatar que o dispositivo não dá suporte a dispersão/coleta, haverá apenas um único elemento na lista de dispersão/coleta passado para essa rotina. A lista de dispersão/coleta é válida até que VideoPortCompleteDma seja chamado.
A última tarefa que a função VideoPortStartDma do driver de porta de vídeo executa é chamar a rotina de retorno de chamada HwVidExecuteDma do driver de miniport. É esse retorno de chamada que realmente executa a operação de transferência de DMA.
HwVidExecuteDma deve estar na memória não paga e não deve acessar nenhum código ou dados pagináveis.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | video.h (inclua Video.h) |