DMA_ABORT_HANDLER função de retorno de chamada (netdma.h)
em Windows 8 e posterior.
Sintaxe
DMA_ABORT_HANDLER DmaAbortHandler;
NTSTATUS DmaAbortHandler(
[in] PVOID ProviderChannelContext
)
{...}
Parâmetros
[in] ProviderChannelContext
Um ponteiro que identifica a área de contexto de um canal DMA. O provedor de DMA retornou esse identificador ao NetDMA no local especificado no parâmetro pProviderChannelContext do Função ProviderAllocateDmaChannel .
Retornar valor
ProviderAbortDma retorna um dos seguintes valores de status:
| Código de retorno | Descrição |
|---|---|
|
A operação foi concluída com sucesso. |
|
A operação falhou por motivos não especificados. |
Comentários
A função ProviderAbortDma é uma função opcional para provedores NetDMA. A interface NetDMA pode chamar a função ProviderAbortDma de um driver de provedor de DMA, se houver, para anular todas as transferências de DMA que foram agendadas em um canal DMA.
No ProviderAbortDma, o provedor de DMA deve encerrar a transferência imediatamente sem concluir a transferência dos dados associados ao descritor de DMA atual. Se a conclusão status relatório estiver habilitada, o mecanismo de DMA gravará o status NetDmaTransferStatusHalted no endereço especificado nos membros CompletionVirtualAddress e CompletionPhysicalAddress no NET_DMA_CHANNEL_PARAMETERS estrutura.
Após a conclusão da operação de anulação, o canal DMA deve estar pronto para que a interface NetDMA chame a função ProviderStartDma . A interface NetDMA não chamará a função ProviderAppendDma até que a transferência seja reiniciada.
O NetDMA chama ProviderAbortDma em IRQL <= DISPATCH_LEVEL.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Com suporte para drivers NetDMA 1.0 no Windows Vista. |
| Plataforma de Destino | Windows |
| Cabeçalho | netdma.h (inclua Netdma.h) |
| IRQL | <= DISPATCH_LEVEL |