OPEN_NDK_ADAPTER_HANDLER función de devolución de llamada (ndisndk.h)

Artículo
02/07/2025

La función OpenNDKAdapterHandler (OPEN_NDK_ADAPTER_HANDLER) abre una instancia del adaptador NDK en un adaptador de miniporte NDIS compatible con NDK.

Sintaxis

OPEN_NDK_ADAPTER_HANDLER OpenNdkAdapterHandler;

NDIS_STATUS OpenNdkAdapterHandler(
  [in] NDIS_HANDLE MiniportAdapterContext,
  [in] PNDIS_OPEN_NDK_ADAPTER_PARAMETERS Parameters,
       NDK_ADAPTER **ppNdkAdapter
)
{...}

Parámetros

[in] MiniportAdapterContext

Identificador de un área de contexto que el controlador de miniporta asignó en su función MiniportInitializeEx. El controlador de miniporte usa este área de contexto para mantener la información de estado de un adaptador de miniporte NDIS.

[in] Parameters

Puntero a una estructura de NDIS_OPEN_NDK_ADAPTER_PARAMETERS que define los parámetros de entrada para abrir una instancia de NDK_ADAPTER.

La estructura de NDIS_OPEN_NDK_ADAPTER_PARAMETERS debe especificar la versión principal de NDKPI y la versión secundaria de NDKPI más baja que el consumidor de NDK puede admitir.

Si el proveedor no admite la versión principal especificada por el consumidor, el proveedor debe producir un error en la solicitud con NDIS_STATUS_BAD_VERSION.

Si el proveedor admite la versión principal especificada por el consumidor y la versión secundaria especificada es menor o igual que la versión secundaria más alta que admite el proveedor, el proveedor debe realizar correctamente la solicitud y usar la versión secundaria más alta que admite el proveedor.

Por ejemplo, si el consumidor solicita la versión 1.0 y el proveedor admite 1.1, el proveedor debe informar de la versión 1.1 en la estructura de NDK_ADAPTER_INFO y los encabezados de objeto NDK.

Nota versiones secundarias superiores en el proveedor siempre son totalmente compatibles con versiones secundarias inferiores (es decir, un superconjunto de).

Si el proveedor admite la versión principal especificada por el consumidor y la versión secundaria especificada es mayor que la versión secundaria más alta que admite el proveedor, el proveedor debe producir un error en la solicitud con NDIS_STATUS_BAD_VERSION.

ppNdkAdapter

Puntero a una variable que contiene el puntero a una estructura de NDK_ADAPTER. Al volver de OPEN_NDK_ADAPTER_HANDLER, la estructura de NDK_ADAPTER a la que hace referencia ppNdkAdapter identifica la instancia del adaptador NDK recién abierta.

Valor devuelto

OPEN_NDK_ADAPTER_HANDLER puede devolver uno de los siguientes valores:

Código devuelto	Descripción
NDIS_STATUS_SUCCESS	La instancia del adaptador NDK se abrió correctamente.
NDIS_STATUS_BAD_VERSION	No se admite el número de versión solicitado.
NDIS_STATUS_ADAPTER_NOT_READY	La funcionalidad NDK del adaptador de miniporte no está habilitada.
NDIS_STATUS_RESOURCES	NDIS no pudo abrir el adaptador NDK debido a recursos insuficientes.

Observaciones

OPEN_NDK_ADAPTER_HANDLER abre una instancia de NDK_ADAPTER en un adaptador de miniporte NDIS compatible con NDK. Se pueden crear varias instancias de NDK_ADAPTER en el mismo adaptador de miniporte NDIS. Cada instancia de NDK_ADAPTER contiene un puntero a una tabla de funciones de distribución que implementan la interfaz de programación de aplicaciones NDK. El controlador de miniporta llama a la función CLOSE_NDK_ADAPTER_HANDLER para cerrar la instancia del adaptador NDK y liberar los recursos asociados.

Requisitos

Requisito	Valor
cliente mínimo admitido	Ninguna compatible, compatible con NDIS 6.30 y versiones posteriores.
servidor mínimo admitido	Windows Server 2012
de la plataforma de destino de	Windows
encabezado de	ndisndk.h
irQL	PASSIVE_LEVEL