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 |