Função NetDmaProviderStop (netdma.h)

Artigo
02/07/2025

Observação não há suporte para a interface NetDMA

no Windows 8 e posterior.

A função NetDmaProviderStop notifica a interface NetDMA de que todos os canais de DMA associados a um provedor de DMA não estão mais disponíveis para transferências de DMA.

Sintaxe

NET_DMA_EXPORT VOID NetDmaProviderStop(
  [in] PVOID NetDmaProviderHandle
);

Parâmetros

[in] NetDmaProviderHandle

Um identificador que identifica um provedor de DMA. O driver do provedor de DMA recebeu esse identificador da interface NetDMA em uma chamada para o função NetDmaRegisterProvider.

Valor de retorno

Nenhum

Observações

Um driver de provedor de DMA chama a função NetDmaProviderStop para notificar a interface NetDMA de que um mecanismo DMA, que foi iniciado chamando a função NetDmaProviderStart, não está mais disponível.

O driver do provedor de DMA deve chamar NetDmaProviderStop antes de chamar a função NetDmaDeregisterProvider para desregister um provedor de DMA.

Os drivers de provedor de DMA normalmente chamam NetDmaProviderStop durante o tratamento do IRP IRP_MN_REMOVE_DEVICE ou IRP_MN_STOP_DEVICE.

Um driver de provedor de DMA pode chamar NetDmaProviderStop e NetDmaProviderStart quantas vezes o aplicativo exigir depois de registrar o provedor de DMA e antes de desregistificar o provedor de DMA. Se um mecanismo DMA estiver sendo reiniciado depois de chamar NetDmaProviderStop, o driver do provedor de DMA poderá especificar novos atributos no NET_DMA_PROVIDER_ATTRIBUTES estrutura no parâmetro ProviderAttributes de NetDmaProviderStart.

A interface NetDMA aguarda a conclusão das operações de DMA pendentes e libera todos os canais de DMA alocados antes de retornar da função de NetDmaProviderStop.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Com suporte para drivers NetDMA 1.0 no Windows Vista.
da Plataforma de Destino	Universal
cabeçalho	netdma.h (inclua Netdma.h)
IRQL	PASSIVE_LEVEL