DMA_RESET_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 ProviderResetChannel redefine um canal DMA para o estado inicial que existia depois que o canal DMA foi alocado.

Sintaxe

DMA_RESET_HANDLER DmaResetHandler;

NTSTATUS DmaResetHandler(
  [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

ProviderResetChannel 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 ProviderResetChannel é uma função opcional para provedores NetDMA. A interface NetDMA chama a função ProviderResetChannel do driver do provedor de DMA, se houver, para redefinir um canal DMA.

Em ProviderResetChannel, o provedor NetDMA deve encerrar qualquer transferência ativa imediatamente sem concluir a transferência dos dados associados ao descritor 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.

Depois que a operação de redefinição for concluída, o canal DMA deverá estar no estado inicial que existia depois que o canal foi alocado. Depois que a interface NetDMA chama ProviderResetChannel, o provedor de DMA não pode acessar nenhum dos descritores de DMA enviados anteriormente. O canal DMA deve estar pronto para que a interface NetDMA chame a função ProviderStartDma .

O NetDMA chama ProviderResetChannel 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

ProviderStartDma