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

Artículo
08/07/2023

La función OpenNDKAdapterHandler (OPEN_NDK_ADAPTER_HANDLER) abre una instancia de adaptador de 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 minipuerto asignó en su función MiniportInitializeEx . El controlador de minipuerto 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 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 admita el proveedor.

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

Nota Las versiones secundarias más altas del 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 de adaptador de 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 minipuerto no está habilitada.
NDIS_STATUS_RESOURCES	NDIS no pudo abrir el adaptador NDK debido a recursos insuficientes.

Comentarios

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 de 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 minipuerto llama a la función CLOSE_NDK_ADAPTER_HANDLER para cerrar la instancia del adaptador de NDK y liberar los recursos asociados.

Requisitos

Requisito	Value
Cliente mínimo compatible	Ninguno compatible, compatible con NDIS 6.30 y versiones posteriores.
Servidor mínimo compatible	Windows Server 2012
Plataforma de destino	Windows
Encabezado	ndisndk.h
IRQL	PASSIVE_LEVEL