DMA_RESET_HANDLER Rückruffunktion (netdma.h)
in Windows 8 und höher.
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 |
|---|---|
|
Der Vorgang wurde erfolgreich abgeschlossen. |
|
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 |