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, der von ProviderAllocateDmaChannel-Funktion zuvor zugeordnet.

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

Keine

Bemerkungen

Die NetDMA-Schnittstelle ruft die ProviderFreeDmaChannel-Funktion eines DMA-Anbietertreibers auf, um einen DMA-Kanal freizugeben. Bevor die NetDMA-Schnittstelle ProviderFreeDmaChannel aufruft, wird sichergestellt, dass in diesem Kanal keine ausstehenden DMA-Vorgänge vorhanden sind.

Nachdem die NetDMA-Schnittstelle ProviderFreeDmaChannel aufgerufen hat, werden keine ProviderXxx-Funktionen für den freigegebenen Kanal aufgerufen.

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

NetDMA ruft ProviderFreeDmaChannel unter IRQL <= DISPATCH_LEVEL auf.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Unterstützt für NetDMA 1.0-Treiber in Windows Vista.
Zielplattform	Windows
Kopfzeile	netdma.h (netdma.h einschließen)
IRQL	<= DISPATCH_LEVEL

Weitere Informationen

NetDmaProviderStop

ProviderAllocateDmaChannel