DMA_CHANNEL_FREE_HANDLER Rückruffunktion (netdma.h)

Hinweis Die NetDMA-Schnittstelle wird nicht unterstützt.

in Windows 8 und höher.

 

Die ProviderFreeDmaChannel Funktion gibt einen DMA-Kanal frei, den der ProviderAllocateDmaChannel zuvor zugeordnete Funktion.

Syntax

DMA_CHANNEL_FREE_HANDLER DmaChannelFreeHandler;

void DmaChannelFreeHandler(
  [in] PVOID ProviderChannelContext
)
{...}

Parameter

[in] ProviderChannelContext

Ein Zeiger, der den Kontextbereich eines DMA-Kanals identifiziert. Der DMA-Anbieter hat dieses Handle an netDMA an dem Speicherort zurückgegeben, der im pProviderChannelContext Parameter des ProviderAllocateDmaChannel Funktion.

Rückgabewert

Nichts

Bemerkungen

Die NetDMA-Schnittstelle ruft die ProviderFreeDmaChannel- funktion eines DMA-Anbieters auf, um einen DMA-Kanal freizugeben. Bevor die NetDMA-Schnittstelle ProviderFreeDmaChannel-aufruft, stellt sie sicher, dass in diesem Kanal keine ausstehenden DMA-Vorgänge vorhanden sind.

Nachdem die NetDMA-Schnittstelle ProviderFreeDmaChannel-aufruft, ruft sie keine ProviderXxx--Funktionen für den freigegebenen Kanal auf.

Die NetDMA-Schnittstelle gibt alle zugeordneten DMA-Kanäle frei, bevor sie von der NetDmaProviderStop--Funktion zurückgegeben wird.

NetDMA ruft ProviderFreeDmaChannel bei IRQL <= DISPATCH_LEVEL auf.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Unterstützt für NetDMA 1.0-Treiber in Windows Vista.
Zielplattform-	Fenster
Header-	netdma.h (enthalten Netdma.h)
IRQL-	<= DISPATCH_LEVEL

Siehe auch

NetDmaProviderStop-

ProviderAllocateDmaChannel