NetDmaProviderStop, fonction (netdma.h)

Article
02/29/2024

Note L’interface NetDMA n’est pas prise en charge

dans Windows 8 et versions ultérieures.

La fonction NetDmaProviderStop informe l’interface NetDMA que tous les canaux DMA associés à un fournisseur DMA ne sont plus disponibles pour les transferts DMA.

Syntaxe

NET_DMA_EXPORT VOID NetDmaProviderStop(
  [in] PVOID NetDmaProviderHandle
);

Paramètres

[in] NetDmaProviderHandle

Handle qui identifie un fournisseur DMA. Le pilote du fournisseur DMA a reçu ce handle de l’interface NetDMA dans un appel à Fonction NetDmaRegisterProvider .

Valeur de retour

None

Remarques

Un pilote de fournisseur DMA appelle la fonction NetDmaProviderStop pour informer l’interface NetDMA qu’un moteur DMA, qui a été démarré en appelant la fonction NetDmaProviderStart, n’est plus disponible.

Le pilote du fournisseur DMA doit appeler NetDmaProviderStop avant d’appeler la fonction NetDmaDeregisterProvider pour désinscrire un fournisseur DMA.

Les pilotes du fournisseur DMA appellent généralement NetDmaProviderStop lors de la gestion des IRP_MN_REMOVE_DEVICE ou IRP_MN_STOP_DEVICE IRP.

Un pilote de fournisseur DMA peut appeler NetDmaProviderStop et NetDmaProviderStart autant de fois que l’application le requiert après l’inscription du fournisseur DMA et avant de désinscrire le fournisseur DMA. Si un moteur DMA est redémarré après qu’il a appelé NetDmaProviderStop, le pilote du fournisseur DMA peut spécifier de nouveaux attributs dans le NET_DMA_PROVIDER_ATTRIBUTES structure au niveau du paramètre ProviderAttributes de NetDmaProviderStart.

L’interface NetDMA attend la fin des opérations DMA en attente et libère tous les canaux DMA alloués avant qu’il ne retourne à partir de la fonction NetDmaProviderStop .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Pris en charge pour les pilotes NetDMA 1.0 dans Windows Vista.
Plateforme cible	Universal
En-tête	netdma.h (inclure Netdma.h)
IRQL	PASSIVE_LEVEL