PEXECUTE_DMA função de retorno de chamada (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 para programar o hardware para iniciar a transferência real de DMA.
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 de Extensões de Dispositivo.
VpDmaAdapter
Ponteiro para a estrutura VP_DMA_ADAPTER que representa o adaptador mestre do barramento. Essa estrutura foi retornada por uma chamada para VideoPortGetDmaAdapter.
SGList
Ponteiro para uma estrutura VP_SCATTER_GATHER_LIST. O driver de porta de vídeo preenche as informações nessa estrutura e passa essa estrutura para o driver de miniporto.
Context
Ponteiro para o contexto determinado pelo driver passado de VideoPortStartDma .
Valor de retorno
Nenhum
Observações
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 o do driver de miniporto HwVidExecuteDma rotina de retorno de chamada. É 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 |
|---|---|
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | video.h (inclua Video.h) |