OPEN_NDK_ADAPTER_HANDLER回调函数 (ndisndk.h)

OpenNDKAdapterHandler (OPEN_NDK_ADAPTER_HANDLER) 函数在支持 NDK 的 NDIS 微型端口适配器上打开 NDK 适配器实例。

语法

OPEN_NDK_ADAPTER_HANDLER OpenNdkAdapterHandler;

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

参数

[in] MiniportAdapterContext

微型端口驱动程序在其 MiniportInitializeEx 函数中分配的上下文区域的句柄。 微型端口驱动程序使用此上下文区域来维护 NDIS 微型端口适配器的状态信息。

[in] Parameters

指向 NDIS_OPEN_NDK_ADAPTER_PARAMETERS 结构的指针,该结构定义用于打开 NDK_ADAPTER 实例的输入参数。

NDIS_OPEN_NDK_ADAPTER_PARAMETERS结构必须指定 NDKPI 主版本,以及 NDK 使用者可以支持的最低 NDKPI 次要版本。

如果提供程序不支持使用者指定的主要版本,则提供程序必须使请求失败并NDIS_STATUS_BAD_VERSION。

如果提供程序支持使用者指定的主要版本,而指定的次要版本小于或等于提供程序支持的最高次要版本,则提供程序必须成功执行请求并使用提供程序支持的最高次要版本。

例如,如果使用者请求版本 1.0,而提供程序支持 1.1,则提供程序必须在 NDK_ADAPTER_INFO 结构和 NDK 对象标头中报告版本 1.1。

注意 提供程序中的较高次要版本始终与 ((即) 较低次要版本的超集)完全向后兼容。
 
如果提供程序支持使用者指定的主要版本,并且指定的次要版本大于提供程序支持的最高次要版本,则提供程序必须使请求失败并NDIS_STATUS_BAD_VERSION。

ppNdkAdapter

指向包含指向NDK_ADAPTER结构的指针 的变量的 指针的指针。 从OPEN_NDK_ADAPTER_HANDLER返回时,ppNdkAdapter 引用的NDK_ADAPTER结构标识新打开的 NDK 适配器实例。

返回值

OPEN_NDK_ADAPTER_HANDLER 可以返回以下值之一:

返回代码 说明
NDIS_STATUS_SUCCESS
已成功打开 NDK 适配器实例。
NDIS_STATUS_BAD_VERSION
不支持请求的版本号。
NDIS_STATUS_ADAPTER_NOT_READY
微型端口适配器的 NDK 功能未启用。
NDIS_STATUS_RESOURCES
由于资源不足,NDIS 无法打开 NDK 适配器。

注解

OPEN_NDK_ADAPTER_HANDLER 在支持 NDK NDIS 微型端口适配器上打开NDK_ADAPTER实例。 可以在同一个 NDIS 微型端口适配器上创建多个 NDK_ADAPTER 实例。 每个 NDK_ADAPTER 实例都包含指向实现 NDK 应用程序编程接口的调度函数表的指针。 微型端口驱动程序调用 CLOSE_NDK_ADAPTER_HANDLER 函数以关闭 NDK 适配器实例并释放关联的资源。

要求

要求
最低受支持的客户端 不支持,NDIS 6.30 及更高版本支持。
最低受支持的服务器 Windows Server 2012
目标平台 Windows
标头 ndisndk.h
IRQL PASSIVE_LEVEL

另请参阅

CLOSE_NDK_ADAPTER_HANDLER

MiniportInitializeEx

NDIS_OPEN_NDK_ADAPTER_PARAMETERS

NDK_ADAPTER

NDK_ADAPTER_DISPATCH

NDK_ADAPTER_INFO