DMA_ABORT_HANDLER Rückruffunktion (netdma.h)
in Windows 8 und höher.
Syntax
DMA_ABORT_HANDLER DmaAbortHandler;
NTSTATUS DmaAbortHandler(
[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
ProviderAbortDma- gibt einen der folgenden Statuswerte zurück:
| Rückgabecode | Beschreibung |
|---|---|
|
Der Vorgang wurde erfolgreich abgeschlossen. |
|
Der Vorgang ist aus nicht angegebenen Gründen fehlgeschlagen. |
Bemerkungen
Die ProviderAbortDma--Funktion ist eine optionale Funktion für NetDMA-Anbieter. Die NetDMA-Schnittstelle kann die ProviderAbortDma--Funktion eines DMA-Anbieters aufrufen, um alle DMA-Übertragungen abzubrechen, die in einem DMA-Kanal geplant wurden.
In ProviderAbortDmasollte der DMA-Anbieter die Übertragung sofort beenden, ohne die Übertragung der Daten abzuschließen, die dem aktuellen DMA-Deskriptor zugeordnet sind. Wenn die Statusberichterstellung für den Abschluss aktiviert ist, schreibt das DMA-Modul den NetDmaTransferStatusHalted- Status in der Adresse, die in der CompletionVirtualAddress und CompletionPhysicalAddress Member in der NET_DMA_CHANNEL_PARAMETERS Struktur.
Nach Abschluss des Abbruchvorgangs muss der DMA-Kanal für die NetDMA-Schnittstelle bereit sein, um die ProviderStartDma--Funktion aufzurufen. Die NetDMA-Schnittstelle ruft die ProviderAppendDma--Funktion erst auf, nachdem die Übertragung neu gestartet wurde.
NetDMA ruft ProviderAbortDma 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 |