NdisMCoIndicateStatusEx 函数 (ndis.h)
NdisMCoIndicateStatusEx 函数报告 CoNDIS 微型端口适配器的状态更改。
语法
void NdisMCoIndicateStatusEx(
[in] NDIS_HANDLE MiniportAdapterHandle,
[in, optional] NDIS_HANDLE NdisVcHandle,
[in] PNDIS_STATUS_INDICATION StatusIndication
);
参数
[in] MiniportAdapterHandle
在 MiniportAdapterHandle 参数中传递的 NDIS 的微型端口适配器句柄 MiniportInitializeEx 函数。
[in, optional] NdisVcHandle
标识虚拟连接的句柄(VC)。 微型端口驱动程序获取此句柄作为其 MiniportCoCreateVc 函数的输入参数,无论是客户端设置传出呼叫还是调用管理器为客户端注册的服务访问点(SAP)创建了 VC 时。 呼叫管理器创建了 VC 以指示传入呼叫通知。 若要向所有协议绑定发送状态指示,请将此参数设置为 NULL。
[in] StatusIndication
指向包含状态信息的 NDIS_STATUS_INDICATION 结构的指针。
返回值
没有
言论
当微型端口驱动程序使用 NdisVcHandle 参数 NULL VC 句柄调用 NdisMCoIndicateStatusEx 时,NDIS 通过调用每个绑定协议驱动程序的 ProtocolCoStatusEx 函数,将状态更改通知转发到所有绑定协议驱动程序。 使用非NULL VC 句柄调用 NdisMCoIndicateStatusEx 会将状态通知限制为微型端口驱动程序与之共享此 VC 句柄的客户端或调用管理器。
微型端口驱动程序可以通过调用 NdisMCoIndicateStatusEx 后调用其注册属性 NdisMSetMiniportAttributes 从其 MiniportInitializeEx 函数 函数,即使驱动程序仍处于 MiniportInitializeEx 函数的上下文中也是如此。 驱动程序在从 MiniportHaltEx 函数返回后,不得调用 NdisMCoIndicateStatusEx。
要求
要求 | 价值 |
---|---|
最低支持的客户端 | NDIS 6.0 及更高版本中受支持。 |
目标平台 | 桌面 |
标头 | ndis.h (包括 Ndis.h) |
库 | Ndis.lib |
IRQL | <= DISPATCH_LEVEL |
DDI 符合性规则 | Irql_MCO_Function(ndis) |