Função NetDmaProviderStop (netdma.h)

Artigo
02/29/2024

Nota Não há suporte para a interface NetDMA

em Windows 8 e posteriores.

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 .

Retornar valor

Nenhum

Comentários

Um driver de provedor de DMA chama a função NetDmaProviderStop para notificar a interface NetDMA de que um mecanismo de 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 desregistrar 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 desregistrar o provedor de DMA. Se um mecanismo de 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 NetDmaProviderStop .

Requisitos

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