NetDmaGetVersion-Funktion (netdma.h)

  • Artikel
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 vom lokalen Computer unterstützt wird.

Syntax

NET_DMA_EXPORT UINT NetDmaGetVersion();

Rückgabewert

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

Rückgabecode Beschreibung
Hohe 16 Bits
 Die Hauptversionsnummer der NetDMA-Schnittstelle.
Niedrige 16 Bits
 Die Nebenversion der NetDMA-Schnittstelle.

Hinweise

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 vom lokalen Computer unterstützte Version der NetDMA-Anbieterschnittstelle ist. Der NetDMA-Anbietertreiber gibt die Haupt- und Nebenversion des NetDMA-Anbieters in den Membern MajorVersion und MinorVersion des NET_DMA_PROVIDER_CHARACTERISTICS Struktur, die an den übergeben wird NetDmaRegisterProvider-Funktion .

HinweisNetDmaGetVersion ist in NetDMA Version 1.0 nicht verfügbar. Um die Verwendung eines Funktionsimports zu vermeiden, der das Laden des Treibers verhindern könnte, muss ein NetDMA 1.1- oder höher-Anbietertreiber überprüfen, ob NetDmaGetVersion vorhanden ist, bevor NetDmaGetVersion aufgerufen wird. Um NetDmaGetVersion aufzurufen, rufen Sie zuerst die NdisGetRoutineAddress-Funktion auf, um den Einstiegspunkt abzurufen, und rufen Sie dann NetDmaGetVersion an dem Von NdisGetRoutineAddress bereitgestellten Einstiegspunkt auf, wenn NetDmaGetVersion verfügbar ist. Wenn der Anbietertreiber die Adresse von NetDmaGetVersion nicht abrufen kann, muss die unterstützte NetDMA-Schnittstelle Version 1.0 sein.
 
NetDMA-Anbietertreiber rufen NetDmaGetVersion unter IRQL = PASSIVE_LEVEL auf.

Anforderungen

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

Weitere Informationen

NET_DMA_PROVIDER_CHARACTERISTICS

NdisGetRoutineAddress

NetDmaRegisterProvider