NdisMCoIndicateStatusEx 函数 (ndis.h)

项目
08/07/2023

NdisMCoIndicateStatusEx 函数报告 CoNDIS 微型端口适配器的状态更改。

语法

void NdisMCoIndicateStatusEx(
  [in]           NDIS_HANDLE             MiniportAdapterHandle,
  [in, optional] NDIS_HANDLE             NdisVcHandle,
  [in]           PNDIS_STATUS_INDICATION StatusIndication
);

参数

[in] MiniportAdapterHandle

微型端口适配器处理 NDIS 在 的 MiniportAdapterHandle 参数中传递的 MiniportInitializeEx 函数。

[in, optional] NdisVcHandle

标识 VC) (虚拟连接的句柄。当客户端设置传出调用或调用管理器为客户端注册的服务访问点创建 VC 时，微型端口驱动程序获取此句柄作为其 MiniportCoCreateVc 函数的输入参数， (SAP) 。呼叫管理器创建了 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)
Library	Ndis.lib
IRQL	<= DISPATCH_LEVEL
DDI 符合性规则	Irql_MCO_Function (ndis)