NetDmaIsr-Funktion (netdma.h)

Artikel
02/29/2024

Hinweis Die NetDMA-Schnittstelle wird nicht unterstützt.

in Windows 8 und höher.

Die NetDmaIsr-Funktion benachrichtigt die NetDMA-Schnittstelle, dass ein DMA-Übertragungsunterbrechung in einem DMA-Kanal aufgetreten ist.

Syntax

NET_DMA_EXPORT VOID NetDmaIsr(
  [in]  PVOID            NetDmaChannelHandle,
  [in]  PHYSICAL_ADDRESS DmaDescriptor,
  [out] PULONG           pCpuNumber
);

Parameter

[in] NetDmaChannelHandle

Ein Handle, das den DMA-Kanal identifiziert. Der DMA-Anbietertreiber hat dieses Handle von der NetDMA-Schnittstelle in einem Aufruf von empfangen. ProviderAllocateDmaChannel-Funktion .

[in] DmaDescriptor

Die physische Adresse des DMA-Deskriptors, der dem Interrupt zugeordnet ist.

[out] pCpuNumber

Die Nummer der CPU, die dem Interrupt-DPC zugeordnet ist. Die NetDMA-Schnittstelle schreibt diese CPU-Nummer an die angegebene Adresse, bevor NetDmaIsr zurückgibt.

Rückgabewert

Keine

Bemerkungen

DMA-Anbietertreiber rufen die NetDmaIsr-Funktion in ihrer Interruptdienstroutine (ISR) auf.

Wenn das NET_DMA_INTERRUPT_ON_COMPLETION-Flag im ControlFlags-Element der NET_DMA_DESCRIPTOR-Struktur festgelegt ist, sollte die DMA-Engine einen Interrupt für den DMA-Kanal generieren, nachdem sie den DMA-Deskriptor verarbeitet hat. Wenn dieses Flag gelöscht wird, generiert die DMA-Engine keinen Interrupt.

Hinweis Wenn die ISR aufgerufen wird, unterscheidet sich der aktuelle DMA-Deskriptor möglicherweise bereits von dem Deskriptor, der den Interrupt ausgelöst hat.

Ein DMA-Anbietertreiber sollte in seinem ISR-Handler so wenig Wie möglich arbeiten. Der Treiber sollte E/A-Vorgänge auf den Interrupt-DPC-Handler zurückstellen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Unterstützt für NetDMA 1.0-Treiber in Windows Vista.
Zielplattform	Universell
Header	netdma.h (netdma.h einschließen)
IRQL	DEVICE_LEVEL

Weitere Informationen

NET_DMA_DESCRIPTOR

ProviderAllocateDmaChannel

Share via