Condividi tramite

Funzione NetDmaGetVersion (netdma.h)

  • Articolo
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 che contiene i numeri di versione principale e secondaria come indicato di seguito:

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

Commenti

I driver del provider NetDMA possono chiamare la funzione NetDmaGetVersion per ottenere la versione dell'interfaccia NetDMA. Un provider NetDMA deve registrarsi 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 nei membri MajorVersion e MinorVersion del NET_DMA_PROVIDER_CHARACTERISTICS struttura che passa all'oggetto Funzione NetDmaRegisterProvider .

NotaNetDmaGetVersion non è disponibile in NetDMA versione 1.0. Per evitare di usare un'importazione di funzione 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 NetDmaGetVersion è disponibile, chiamare NetDmaGetVersion nel punto di ingresso fornito da NdisGetRoutineAddress . 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.

Requisiti

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

Vedi anche

NET_DMA_PROVIDER_CHARACTERISTICS

NdisGetRoutineAddress

NetDmaRegisterProvider