NetDmaProviderStart-Funktion (netdma.h)

Artikel
02/29/2024

Hinweis Die NetDMA-Schnittstelle wird nicht unterstützt.

in Windows 8 und höher.

Die NetDmaProviderStart-Funktion benachrichtigt die NetDMA-Schnittstelle, dass alle DMA-Kanäle, die einem DMA-Anbieter zugeordnet sind, initialisiert und für DMA-Übertragungen bereit sind.

Syntax

NET_DMA_EXPORT VOID NetDmaProviderStart(
  [in] PVOID                        NetDmaProviderHandle,
  [in] PNET_DMA_PROVIDER_ATTRIBUTES ProviderAttributes
);

Parameter

[in] NetDmaProviderHandle

Ein Handle, das einen DMA-Anbieter identifiziert. Der DMA-Anbietertreiber hat dieses Handle von der NetDMA-Schnittstelle in einem Aufruf von empfangen. NetDmaRegisterProvider-Funktion .

[in] ProviderAttributes

Ein Zeiger auf eine NET_DMA_PROVIDER_ATTRIBUTES Struktur, die die DMA-Geräteattribute des DMA-Anbieters definiert.

Rückgabewert

Keine

Bemerkungen

DMA-Anbieter rufen die NetDmaProviderStart-Funktion auf, um die NetDMA-Schnittstelle zu benachrichtigen, dass ein DMA-Anbieter gestartet wurde. Ein DMA-Anbietertreiber initialisiert eine DMA-Engine und ruft die NetDmaProviderStart-Funktion auf, während die IRP_MN_START_DEVICE IRP verarbeitet wird.

Der DMA-Anbietertreiber kann aus anwendungsspezifischen Gründen auch NetDmaProviderStart aufrufen, nachdem der Treiber die NetDmaProviderStop-Funktion aufgerufen hat. DMA-Anbietertreiber rufen NetDmaProviderStop auf, um die NetDMA-Schnittstelle zu benachrichtigen, dass ein zuvor gestarteter DMA-Anbieter nicht mehr verfügbar ist.

Der DMA-Anbietertreiber stellt ein NET_DMA_PROVIDER_ATTRIBUTES Struktur am ProviderAttributes-Parameter von NetDmaProviderStart. Die NET_DMA_PROVIDER_ATTRIBUTES-Struktur gibt die Konfigurationsattribute für einen NetDMA-Anbieter an.

Bevor ein DMA-Anbietertreiber NetDmaProviderStart aufruft, sollte er bereit sein, alle NetDMA-Schnittstellenanforderungen zu verarbeiten, z. B. das Zuweisen von DMA-Kanälen und das Ausführen von DMA-Übertragungen.

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	PASSIVE_LEVEL

Weitere Informationen

IRP_MN_START_DEVICE

NET_DMA_PROVIDER_ATTRIBUTES

NetDmaProviderStop

NetDmaRegisterProvider

Freigeben über