NdisIMGetDeviceContext 函数 (ndis.h)

  • 项目

注意 NDIS 5。 x 已弃用，由 NDIS 6 取代。 x。 有关新的 NDIS 驱动程序开发，请参阅 从 Windows Vista 开始的网络驱动程序。 有关移植 NDIS 5 的信息。 NDIS 6 的 x 驱动程序。 x，请参阅 将 NDIS 5.x 驱动程序移植到 NDIS 6.0。

此函数允许 NDIS 中间驱动程序的 MiniportInitialize 函数访问其 ProtocolBindAdapter 函数分配的设备上下文区域。

语法

NDIS_HANDLE NdisIMGetDeviceContext(
  [in] NDIS_HANDLE MiniportAdapterHandle
);

参数

[in] MiniportAdapterHandle

指定 MiniportInitialize 的句柄输入。

返回值

下表显示了此函数的返回值。

值 说明
NDISIMGETDEVICECONTEXT 返回对 MiniportAdapterHandle 标识的虚拟 NIC 的设备上下文区域的访问权限。
Null 如果驱动程序的 ProtocolBindAdapter 函数未分配此类设备上下文区域。

注解

NDIS 中间驱动程序的 MiniportInitialize 函数调用 NdisIMGetDeviceContext 来访问它正在初始化的虚拟 NIC 的设备上下文区域。 通常，此类区域的内存由中间驱动程序的 ProtocolBindAdapter 函数提供，该函数使用指向此区域的指针调用 NdisIMInitializeDeviceInstanceEx ，从而导致调用驱动程序的 MiniportInitialize 函数。 但是，中间驱动程序不需要具有这样的上下文区域。

从 NdisIMGetDeviceContext 返回时， MiniportInitialize 为虚拟 NIC 设置驱动程序定义的状态，其中包含中间驱动程序编写器希望对更高级别的协议（随后绑定到其虚拟 NIC）有用的任何信息。

绑定到同一虚拟 NIC 的更高级别的 NDIS 协议随后可以通过从其 ProtocolBindAdapter 函数调用 NdisIMGetBindingContext 来访问此设备上下文区域。

OS 版本：Windows CE .NET 4.0 及更高版本。

要求

要求 值
Header ndis.h
Library Ndis.lib
IRQL IRQL <= DISPATCH_LEVEL

另请参阅