NdisIMGetDeviceContext 函数 （ndis.h）
注释 NDIS 5。 x 已被弃用，并被 NDIS 6 取代。 x。 有关新的 NDIS 驱动程序开发，请参阅从 Windows Vista 开始网络驱动程序。 有关移植 NDIS 5 的信息。 将 x 驱动程序 到 NDIS 6。 x，请参阅 将 NDIS 5.x 驱动程序移植到 NDIS 6.0。
此函数允许 NDIS 中间驱动程序的 MiniportInitialize 函数访问其 ProtocolBindAdapter 函数分配的设备上下文区域。
语法
NDIS_HANDLE NdisIMGetDeviceContext(
[in] NDIS_HANDLE MiniportAdapterHandle
);
参数
[in] MiniportAdapterHandle
指定要 MiniportInitialize的句柄输入。
返回值
下表显示了此函数的返回值。
| 价值 | 描述 |
|---|---|
| NDISIMGETDEVICECONTEXT | 返回对由 MiniportAdapterHandle标识的虚拟 NIC 的设备上下文区域的访问权限。 |
| 零 | 如果驱动程序的 ProtocolBindAdapter 函数未分配此类设备上下文区域。 |
言论
NDIS 中间驱动程序的 MiniportInitialize 函数调用 NdisIMGetDeviceContext 以访问正在初始化的虚拟 NIC 的设备上下文区域。 通常，此类区域的内存由中间驱动程序的 ProtocolBindAdapter 函数提供，该函数使用指向此区域的指针调用 NdisIMInitializeDeviceInstanceEx，从而使驱动程序 MiniportInitialize 函数调用。 但是，中间驱动程序不需要具有此类上下文区域。
从 NdisIMGetDeviceContext返回时，MiniportInitialize 设置虚拟 NIC 的驱动程序定义状态，而中间驱动程序编写器打算用于后续绑定到其虚拟 NIC 的更高级别的协议。
绑定到同一虚拟 NIC 的更高级别的 NDIS 协议随后可以通过从其 ProtocolBindAdapter 函数调用 NdisIMGetBindingContext 来访问此设备上下文区域。
OS 版本： Windows CE .NET 4.0 及更高版本。
要求
| 要求 | 价值 |
|---|---|
| 标头 | ndis.h |
| 库 | Ndis.lib |
| IRQL | IRQL <= DISPATCH_LEVEL |