Función NetDmaGetVersion (netdma.h)

  • Artículo
Nota No se admite la interfaz NetDMA.

en Windows 8 y versiones posteriores.

 

La función NetDmaGetVersion devuelve la versión de la interfaz netDMA que admite el equipo local.

Sintaxis

NET_DMA_EXPORT UINT NetDmaGetVersion();

Valor devuelto

NetDmaGetVersion devuelve un valor UINT que contiene los números de versión principal y secundaria de la siguiente manera:

Código devuelto Descripción
16 bits altos
 Número de versión principal de la interfaz NetDMA.
16 bits bajos
 La versión secundaria de la interfaz NetDMA.

Comentarios

Los controladores del proveedor netDMA pueden llamar a la función NetDmaGetVersion para obtener la versión de la interfaz netDMA. Un proveedor netDMA debe registrarse como proveedor de NetDMA con una versión igual o inferior a la versión de la interfaz del proveedor netDMA compatible con el equipo local. El controlador del proveedor netDMA especifica la versión principal y secundaria del proveedor NetDMA en los miembros MajorVersion y MinorVersion de la NET_DMA_PROVIDER_CHARACTERISTICS estructura que pasa al Función NetDmaRegisterProvider .

NotaNetDmaGetVersion no está disponible en la versión 1.0 de NetDMA. Para evitar el uso de una importación de función que podría impedir que el controlador se cargue, un controlador de proveedor NetDMA 1.1 o posterior debe comprobar la presencia de NetDmaGetVersion antes de llamar a NetDmaGetVersion. Para llamar a NetDmaGetVersion, primero llame a la función NdisGetRoutineAddress para obtener el punto de entrada y, a continuación, si NetDmaGetVersion está disponible, llame a NetDmaGetVersion en el punto de entrada que proporcionó NdisGetRoutineAddress . Si el controlador de proveedor no puede obtener la dirección de NetDmaGetVersion, la interfaz netDMA admitida debe ser la versión 1.0.
 
Los controladores del proveedor netDMA llaman a NetDmaGetVersion en IRQL = PASSIVE_LEVEL.

Requisitos

Requisito Value
Cliente mínimo compatible Compatible con los controladores NetDMA 2.0 y NetDMA 1.1 en Windows Server 2008.
Plataforma de destino Universal
Encabezado netdma.h (incluya Netdma.h)
IRQL PASSIVE_LEVEL

Consulte también

NET_DMA_PROVIDER_CHARACTERISTICS

NdisGetRoutineAddress

NetDmaRegisterProvider