NetDmaGetVersion-Funktion (netdma.h)

Hinweis Die NetDMA-Schnittstelle wird nicht unterstützt.

in Windows 8 und höher.

 

Die NetDmaGetVersion--Funktion gibt die Version der NetDMA-Schnittstelle zurück, die der lokale Computer unterstützt.

Syntax

NET_DMA_EXPORT UINT NetDmaGetVersion();

Rückgabewert

NetDmaGetVersion gibt einen UINT-Wert zurück, der die Haupt- und Nebenversionsnummern wie folgt enthält:

Rückgabecode	Beschreibung
high 16 bits	Die Hauptversionsnummer der NetDMA-Schnittstelle.
low 16 bits	Die Nebenversion der NetDMA-Schnittstelle.

Bemerkungen

NetDMA-Anbietertreiber können die NetDmaGetVersion--Funktion aufrufen, um die Version der NetDMA-Schnittstelle abzurufen. Ein NetDMA-Anbieter muss sich als NetDMA-Anbieter mit einer Version registrieren, die gleich oder niedriger als die NetDMA-Anbieterschnittstellenversion ist, die der lokale Computer unterstützt. Der NetDMA-Anbietertreiber gibt die Haupt- und Nebenversion des NetDMA-Anbieters im MajorVersion- und MinorVersion- Mitglieder der NET_DMA_PROVIDER_CHARACTERISTICS Struktur, die sie an die NetDmaRegisterProvider Funktion.

HinweisNetDmaGetVersion- in NetDMA Version 1.0 nicht verfügbar ist. Um zu vermeiden, dass ein Funktionsimport verwendet wird, der das Laden des Treibers verhindert, muss ein NetDMA 1.1- oder höher-Anbietertreiber das Vorhandensein von NetDmaGetVersion- überprüfen, bevor er NetDmaGetVersionaufruft. Rufen Sie zum Aufrufen NetDmaGetVersion-zuerst die NdisGetRoutineAddress-Funktion auf, um den Einstiegspunkt abzurufen, und rufen Sie dann, wenn NetDmaGetVersion- verfügbar ist, NetDmaGetVersion- an dem Einstiegspunkt auf, der NdisGetRoutineAddress bereitgestellt. Wenn der Anbietertreiber die Adresse NetDmaGetVersion-nicht abrufen kann, muss die unterstützte NetDMA-Schnittstelle Version 1.0 sein.

 

NetDMA-Anbietertreiber rufen NetDmaGetVersion- bei IRQL = PASSIVE_LEVEL auf.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Unterstützt für NetDMA 2.0- und NetDMA 1.1-Treiber in Windows Server 2008.
Zielplattform-	Universal
Header-	netdma.h (enthalten Netdma.h)
IRQL-	PASSIVE_LEVEL

Siehe auch

NET_DMA_PROVIDER_CHARACTERISTICS

NdisGetRoutineAddress

NetDmaRegisterProvider-