NetDmaProviderStart-Funktion (netdma.h)
in Windows 8 und höher.
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 an die NetDmaRegisterProvider Funktion.
[in] ProviderAttributes
Ein Zeiger auf ein NET_DMA_PROVIDER_ATTRIBUTES Struktur, die die DMA-Geräteattribute des DMA-Anbieters definiert.
Rückgabewert
Nichts
Bemerkungen
DMA-Anbieter rufen die NetDmaProviderStart--Funktion auf, um die NetDMA-Schnittstelle zu benachrichtigen, dass ein DMA-Anbieter gestartet wird. Ein DMA-Anbietertreiber initialisiert ein DMA-Modul und ruft die NetDmaProviderStart--Funktion auf, während die IRP_MN_START_DEVICE IRP verarbeitet wird.
Der DMA-Anbietertreiber kann auch NetDmaProviderStart- aufrufen, nachdem der Treiber die NetDmaProviderStop--Funktion aus anwendungsspezifischen Gründen 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 einen 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 |
|---|---|
| mindestens unterstützte Client- | Unterstützt für NetDMA 1.0-Treiber in Windows Vista. |
| Zielplattform- | Universal |
| Header- | netdma.h (enthalten Netdma.h) |
| IRQL- | PASSIVE_LEVEL |