DMA_RESET_HANDLER Rückruffunktion (netdma.h)

Syntax

DMA_RESET_HANDLER DmaResetHandler;

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

ProviderResetChannel gibt einen der folgenden Statuswerte zurück:

Bemerkungen

Die ProviderResetChannel--Funktion ist eine optionale Funktion für NetDMA-Anbieter. Die NetDMA-Schnittstelle ruft die ProviderResetChannel-Funktion des DMA-Anbieters auf, um einen DMA-Kanal zurückzusetzen.

In ProviderResetChannelsollte der NetDMA-Anbieter jede aktive Ü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 Rücksetzungsvorgangs muss sich der DMA-Kanal im Anfangszustand befinden, der nach der Zuordnung des Kanals vorhanden war. Nachdem die NetDMA-Schnittstelle ProviderResetChannelaufgerufen hat, kann der DMA-Anbieter nicht auf die zuvor übermittelten DMA-Deskriptoren zugreifen. Der DMA-Kanal muss für die NetDMA-Schnittstelle bereit sein, um die ProviderStartDma--Funktion aufzurufen.

NetDMA ruft ProviderResetChannel- bei IRQL-<= DISPATCH_LEVEL auf.

Anforderungen

Siehe auch

NET_DMA_CHANNEL_PARAMETERS

ProviderAllocateDmaChannel

ProviderStartDma-