DMA_CHANNEL_FREE_HANDLER Rückruffunktion (netdma.h)
in Windows 8 und höher.
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 |