DMA_RESUME_HANDLER Rückruffunktion (netdma.h)

  • Artikel
Hinweis Die NetDMA-Schnittstelle wird nicht unterstützt.

in Windows 8 und höher.

 
Die ProviderResumeDma-Funktion setzt die DMA-Übertragungen fort, die derzeit in einem DMA-Kanal angehalten sind.

Syntax

DMA_RESUME_HANDLER DmaResumeHandler;

NTSTATUS DmaResumeHandler(
  [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

ProviderResumeDma gibt einen der folgenden status Werte zurück:

Rückgabecode Beschreibung
STATUS_SUCCESS
 Der Vorgang wurde erfolgreich abgeschlossen.
STATUS_UNSUCCESSFUL
 Der Vorgang ist aus nicht angegebenen Gründen fehlgeschlagen.

Hinweise

Die ProviderSuspendDma-Funktion ist eine optionale Funktion für NetDMA-Anbieter. Die NetDMA-Schnittstelle ruft ggf. die ProviderResumeDma-Funktion auf, um DMA-Vorgänge fortzusetzen, die durch Aufrufen der ProviderSuspendDma-Funktion angehalten wurden. Wenn der DMA-Anbietertreiber einen Einstiegspunkt für eine ProviderSuspendDma-Funktion angibt, muss er auch einen Einstiegspunkt für eine ProviderResumeDma-Funktion angeben.

Wenn die DMA-Engine die Übertragungen fortführt, sollte die Hardware den zuletzt verarbeiteten DMA-Deskriptor erneut laden, um den neuen nächsten Deskriptor abzurufen.

NetDMA ruft ProviderResumeDma 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

ProviderAllocateDmaChannel

ProviderSuspendDma