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

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:

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

Confira também

NET_DMA_CHANNEL_PARAMETERS

ProviderAllocateDmaChannel

ProviderStartDma