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。
ppNdkAdapter
指向包含指向NDK_ADAPTER结构的指针 的变量的 指针的指针。 从OPEN_NDK_ADAPTER_HANDLER返回时,ppNdkAdapter 引用的NDK_ADAPTER结构标识新打开的 NDK 适配器实例。
返回值
OPEN_NDK_ADAPTER_HANDLER 可以返回以下值之一:
返回代码 | 说明 |
---|---|
|
已成功打开 NDK 适配器实例。 |
|
不支持请求的版本号。 |
|
微型端口适配器的 NDK 功能未启用。 |
|
由于资源不足,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 |