DMA_RESET_HANDLER função de retorno de chamada (netdma.h)
em Windows 8 e posterior.
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 |
|---|---|
|
A operação foi concluída com sucesso. |
|
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 |