Funzione NetDmaProviderStop (netdma.h)

Articolo
02/07/2025

Nota L'interfaccia NetDMA non è supportata

in Windows 8 e versioni successive.

La funzione NetDmaProviderStop notifica all'interfaccia NetDMA che tutti i canali DMA associati a un provider DMA non sono più disponibili per i trasferimenti DMA.

Sintassi

NET_DMA_EXPORT VOID NetDmaProviderStop(
  [in] PVOID NetDmaProviderHandle
);

Parametri

[in] NetDmaProviderHandle

Handle che identifica un provider DMA. Il driver del provider DMA ha ricevuto questo handle dall'interfaccia NetDMA in una chiamata al funzione NetDmaRegisterProvider.

Valore restituito

Nessuno

Osservazioni

Un driver del provider DMA chiama la funzione netDmaProviderStop per notificare all'interfaccia NetDMA che un motore DMA, avviato chiamando la funzione NetDmaProviderStart, non è più disponibile.

Il driver del provider DMA deve chiamare NetDmaProviderStop prima di chiamare la funzione NetDmaDeregisterProvider per annullare la registrazione di un provider DMA.

I driver del provider DMA chiamano in genere NetDmaProviderStop durante la gestione del IRP_MN_REMOVE_DEVICE o IRP_MN_STOP_DEVICE IRP.

Un driver del provider DMA può chiamare NetDmaProviderStop e NetDmaProviderStart quante volte l'applicazione richiede dopo aver registrato il provider DMA e prima di annullare la registrazione del provider DMA. Se un motore DMA viene riavviato dopo aver chiamato NetDmaProviderStop, il driver del provider DMA può specificare nuovi attributi nel NET_DMA_PROVIDER_ATTRIBUTES struttura nel parametro ProviderAttributes di NetDmaProviderStart.

L'interfaccia NetDMA attende il completamento delle operazioni DMA in sospeso e libera tutti i canali DMA allocati prima che venga restituito dalla funzione NetDmaProviderStop.

Fabbisogno

Requisito	Valore
client minimo supportato	Supportato per i driver NetDMA 1.0 in Windows Vista.
piattaforma di destinazione	Universale
intestazione	netdma.h (include Netdma.h)
IRQL	PASSIVE_LEVEL