NetDmaProviderStop-Funktion (netdma.h)

Artikel
02/29/2024

Hinweis Die NetDMA-Schnittstelle wird nicht unterstützt.

in Windows 8 und höher.

Die NetDmaProviderStop-Funktion benachrichtigt die NetDMA-Schnittstelle darüber, dass alle DMA-Kanäle, die einem DMA-Anbieter zugeordnet sind, nicht mehr für DMA-Übertragungen verfügbar sind.

Syntax

NET_DMA_EXPORT VOID NetDmaProviderStop(
  [in] PVOID NetDmaProviderHandle
);

Parameter

[in] NetDmaProviderHandle

Ein Handle, das einen DMA-Anbieter identifiziert. Der DMA-Anbietertreiber hat dieses Handle von der NetDMA-Schnittstelle in einem Aufruf des NetDmaRegisterProvider-Funktion .

Rückgabewert

Keine

Bemerkungen

Ein DMA-Anbietertreiber ruft die NetDmaProviderStop-Funktion auf, um die NetDMA-Schnittstelle zu benachrichtigen, dass eine DMA-Engine, die durch Aufrufen der NetDmaProviderStart-Funktion gestartet wurde, nicht mehr verfügbar ist.

Der DMA-Anbietertreiber muss NetDmaProviderStop aufrufen, bevor er die NetDmaDeregisterProvider-Funktion aufruft, um die Registrierung eines DMA-Anbieters aufzuheben.

DMA-Anbietertreiber rufen in der Regel NetDmaProviderStop auf, während sie die IRP_MN_REMOVE_DEVICE oder IRP_MN_STOP_DEVICE IRP verarbeiten.

Ein DMA-Anbietertreiber kann NetDmaProviderStop und NetDmaProviderStart so oft aufrufen, wie die Anwendung nach der Registrierung des DMA-Anbieters und vor dem Aufheben der Registrierung des DMA-Anbieters benötigt. Wenn eine DMA-Engine nach dem Namen NetDmaProviderStop neu gestartet wird, kann der DMA-Anbietertreiber neue Attribute im NET_DMA_PROVIDER_ATTRIBUTES Struktur am ProviderAttributes-Parameter von NetDmaProviderStart.

Die NetDMA-Schnittstelle wartet auf den Abschluss ausstehender DMA-Vorgänge und gibt alle zugeordneten DMA-Kanäle frei, bevor sie von der NetDmaProviderStop-Funktion zurückgegeben wird.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Unterstützt für NetDMA 1.0-Treiber in Windows Vista.
Zielplattform	Universell
Header	netdma.h (include Netdma.h)
IRQL	PASSIVE_LEVEL