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 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 |