DMA_ABORT_HANDLER função de retorno de chamada (netdma.h)

Nota Não há suporte para a interface NetDMA

em Windows 8 e posterior.

 

A função ProviderAbortDma cancela todas as transferências de DMA associadas a um canal DMA.

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
STATUS_SUCCESS	A operação foi concluída com sucesso.
STATUS_UNSUCCESSFUL	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

Confira também

NET_DMA_CHANNEL_PARAMETERS

ProviderAllocateDmaChannel

ProviderAppendDma

ProviderStartDma