Freigeben über


DMA_RESET_HANDLER Rückruffunktion (netdma.h)

Hinweis Die NetDMA-Schnittstelle wird nicht unterstützt.

in Windows 8 und höher.

 
Die ProviderResetChannel-Funktion setzt einen DMA-Kanal auf den ursprünglichen Zustand zurück, der nach der Zuweisung des DMA-Kanals vorhanden war.

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 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 ProviderResetChannel-Funktion ist eine optionale Funktion für NetDMA-Anbieter. Die NetDMA-Schnittstelle ruft ggf. die ProviderResetChannel-Funktion des DMA-Anbietertreibers auf, um einen DMA-Kanal zurückzusetzen.

In ProviderResetChannel sollte der NetDMA-Anbieter jede aktive Übertragung sofort beenden, ohne die Übertragung der Daten abzuschließen, die dem aktuellen DMA-Deskriptor zugeordnet sind. Wenn der Abschluss status Berichterstellung aktiviert ist, schreibt die DMA-Engine den NetDmaTransferStatusHalted-status in die Adresse, die in den Membern CompletionVirtualAddress und CompletionPhysicalAddress im NET_DMA_CHANNEL_PARAMETERS Struktur.

Nach Abschluss des Zurücksetzungsvorgangs muss sich der DMA-Kanal in dem ursprünglichen Zustand befinden, der nach der Zuordnung des Kanals vorhanden war. Nachdem die NetDMA-Schnittstelle ProviderResetChannel aufgerufen hat, kann der DMA-Anbieter auf keine der zuvor übermittelten DMA-Deskriptoren zugreifen. Der DMA-Kanal muss bereit sein, damit die NetDMA-Schnittstelle die ProviderStartDma-Funktion aufrufen kann.

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

NET_DMA_CHANNEL_PARAMETERS

ProviderAllocateDmaChannel

ProviderStartDma