DMA_SUSPEND_HANDLER Rückruffunktion (netdma.h)

Syntax

DMA_SUSPEND_HANDLER DmaSuspendHandler;

NTSTATUS DmaSuspendHandler(
  [in]  PVOID ProviderChannelContext,
  [out] PPHYSICAL_ADDRESS *pLastDescriptor
)
{...}

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.

[out] pLastDescriptor

Ein Zeiger auf eine Variable, die die physische Adresse des letzten erfolgreich verarbeiteten DMA-Deskriptors enthält. Der DMA-Anbieter stellt diese Adresse vor der Rückgabe von ProviderSuspendDmabereit.

Rückgabewert

ProviderSuspendDma gibt einen der folgenden Statuswerte zurück:

Bemerkungen

Die ProviderSuspendDma--Funktion ist eine optionale Funktion für NetDMA-Anbieter. Die NetDMA-Schnittstelle kann den ProviderSuspendDma--Funktion aufrufen, um ggf. alle DMA-Übertragungen, die in Einem DMA-Kanal ausgeführt werden, vorübergehend auszusetzen.

Der DMA-Anbieter schließt die Übertragung des aktuellen DMA-Deskriptors ab, bevor er von ProviderSuspendDmazurückgibt. Wenn die Statusberichterstellung für den Abschluss aktiviert ist, schreibt das DMA-Modul den NetDmaTransferStatusSuspend Status in der Adresse, die in der CompletionVirtualAddress angegeben ist, und CompletionPhysicalAddress Member in den Membern NET_DMA_CHANNEL_PARAMETERS Struktur.

Während die DMA-Übertragungen angehalten werden, kann die NetDMA-Schnittstelle die verknüpfte DMA-Deskriptorliste ändern (z. B. zum Einfügen oder Löschen von Deskriptoren).

Die NetDMA-Schnittstelle ruft die ProviderResumeDma--Funktion auf, um DMA-Vorgänge fortzusetzen, die durch Aufrufen ProviderSuspendDmaangehalten wurden.

NetDMA ruft ProviderSuspendDma bei IRQL-<= DISPATCH_LEVEL auf.

Anforderungen

Siehe auch

NET_DMA_CHANNEL_PARAMETERS

ProviderAllocateDmaChannel

ProviderResumeDma-