Partager via


NetDmaProviderStop, fonction (netdma.h)

Remarque 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 de fournisseur DMA a reçu ce handle de l’interface NetDMA dans un appel au fonction NetDmaRegisterProvider.

Valeur de retour

Aucun

Remarques

Un pilote de fournisseur DMA appelle la fonction NetDmaProviderStop pour avertir 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 de 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 l’exige 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 que les opérations DMA en attente se terminent et libèrent tous les canaux DMA alloués avant de retourner à partir de la fonction NetDmaProviderStop.

Exigences

Exigence Valeur
client minimum pris en charge Pris en charge pour les pilotes NetDMA 1.0 dans Windows Vista.
plateforme cible Universel
d’en-tête netdma.h (include Netdma.h)
IRQL PASSIVE_LEVEL

Voir aussi

IRP_MN_REMOVE_DEVICE

IRP_MN_STOP_DEVICE

NET_DMA_PROVIDER_ATTRIBUTES

netDmaDeregisterProvider

NetDmaProviderStart

netDmaRegisterProvider