Compartir a través de


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

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

Consulte también

CLOSE_NDK_ADAPTER_HANDLER

MiniportInitializeEx

NDIS_OPEN_NDK_ADAPTER_PARAMETERS

NDK_ADAPTER

NDK_ADAPTER_DISPATCH

NDK_ADAPTER_INFO