OPEN_NDK_ADAPTER_HANDLER回调函数 (ndisndk.h)

项目
08/07/2023

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