Funzione NetDmaGetVersion (netdma.h)

Nota L'interfaccia NetDMA non è supportata

in Windows 8 e versioni successive.

 

La funzione NetDmaGetVersion restituisce la versione dell'interfaccia NetDMA supportata dal computer locale.

Sintassi

NET_DMA_EXPORT UINT NetDmaGetVersion();

Valore restituito

NetDmaGetVersion restituisce un valore UINT contenente i numeri di versione principali e secondari come indicato di seguito:

Codice restituito	Descrizione
alti 16 bit	Numero di versione principale dell'interfaccia NetDMA.
16 bit bassi	Versione secondaria dell'interfaccia NetDMA.

Osservazioni

I driver del provider NetDMA possono chiamare la funzione NetDmaGetVersion per ottenere la versione dell'interfaccia NetDMA. Un provider NetDMA deve essere registrato come provider NetDMA con una versione uguale o inferiore alla versione dell'interfaccia del provider NetDMA supportata dal computer locale. Il driver del provider NetDMA specifica la versione principale e secondaria del provider NetDMA nel MajorVersion e MinorVersion membri del NET_DMA_PROVIDER_CHARACTERISTICS struttura passata all'oggetto funzione NetDmaRegisterProvider.

Nota NetDmaGetVersion non è disponibile in NetDMA versione 1.0. Per evitare di usare un'importazione di funzioni che potrebbe impedire il caricamento del driver, un driver del provider NetDMA 1.1 o versione successiva deve verificare la presenza di NetDmaGetVersion prima di chiamare NetDmaGetVersion. Per chiamare NetDmaGetVersion, chiamare prima la funzione NdisGetRoutineAddress per ottenere il punto di ingresso e quindi, se è disponibile NetDmaGetVersion, chiamare NetDmaGetVersion nel punto di ingresso che NdisGetRoutineAddress fornito. Se il driver del provider non riesce a ottenere l'indirizzo di NetDmaGetVersion, l'interfaccia NetDMA supportata deve essere la versione 1.0.

 

I driver del provider NetDMA chiamano NetDmaGetVersion in IRQL = PASSIVE_LEVEL.

Fabbisogno

Requisito	Valore
client minimo supportato	Supportato per i driver NetDMA 2.0 e NetDMA 1.1 in Windows Server 2008.
piattaforma di destinazione	Universale
intestazione	netdma.h (include Netdma.h)
IRQL	PASSIVE_LEVEL

Vedere anche

NET_DMA_PROVIDER_CHARACTERISTICS

NdisGetRoutineAddress

NetDmaRegisterProvider