NdisMCmActivateVc 函数 (ndis.h)
NdisMCmActivateVc 通知 NDIS MCM 驱动程序已准备好在特定 VC 上进行传输。
语法
NDIS_STATUS NdisMCmActivateVc(
[in] NDIS_HANDLE NdisVcHandle,
[in] PCO_CALL_PARAMETERS CallParameters
);
参数
[in] NdisVcHandle
指定标识 VC 的句柄。
[in] CallParameters
指向调用方分配的缓冲区的指针,格式化为类型 CO_CALL_PARAMETERS的结构,其中包含微型端口驱动程序用于激活的 VC 的所有特定于媒体的参数。
返回值
NdisMCmActivateVc 返回除NDIS_STATUS_PENDING以外的任何内容时,MCM 驱动程序应对其进行内部调用 ProtocolCmActivateVcComplete 函数。 否则,NDIS 会在此作完成后调用 MCM 驱动程序的 ProtocolCmActivateVcComplete 函数。
言论
NdisMCmActivateVc 通知 NDIS MCM 驱动程序已在新创建的 VC 上设置呼叫和媒体参数,或更改已建立的 VC 上的调用参数。
MCM 驱动程序必须在在 VC 上建立连接之后、在该 VC 上发送或接收任何数据之前调用 NdisMCmActivateVc。 此调用通知 NDIS 微型端口驱动程序已准备好在 VC 上进行传输的 NIC。
对于客户端发起的传出呼叫,MCM 驱动程序通常调用 NdisMCmActivateVc,然后握手表示与远程节点的协商协议或在交换机上成功调用设置,然后通知 NDIS(和客户端)通过 NdisMCmMakeCallComplete完成传出呼叫。 对于传入呼叫,MCM 驱动程序通常在成功调用 NdisMCmCreateVc 后调用 NdisMCmActivateVc NdisMCmDispatchIncomingCall。
驱动程序编写器确定 MCM 驱动程序是否具有 MiniportCoActivateVc 函数,驱动程序在设置传出和传入调用的连接时调用。
在连接期间,MCM 驱动程序可以在网络更改和/或客户端调用 NdisClModifyCallQoS时修改调用参数。 如果 MCM 驱动程序可以根据新修改的调用参数继续对 VC 进行传输,则必须更新它对新值的调用参数保持的状态。 它必须调用 NdisMCmActivateVc,以通知 NDIS 活动 VC 的调用参数中的任何更改。 否则,MCM 驱动程序可以执行以下作之一:
- 在客户端请求修改 VC 的 QoS 或其他调用参数后,调用 NdisMCmDeactivateVc,这样一种状态是微型端口驱动程序无法继续在 VC 上进行传输。
- 将调用参数还原到以前接受的状态,通知客户端请求更改,并随时可以继续传输 VC 上的数据。 在这种情况下,客户端可以选择接受还原的调用参数或拒绝这些参数并启动关闭 VC。
要求
要求 | 价值 |
---|---|
最低支持的客户端 | Windows Vista 中支持 NDIS 6.0 和 NDIS 5.1 驱动程序(请参阅 NdisMCmActivateVc(NDIS 5.1)。 在 Windows XP 中支持 NDIS 5.1 驱动程序(请参阅 NdisMCmActivateVc (NDIS 5.1)。 |
目标平台 | 桌面 |
标头 | ndis.h (包括 Ndis.h) |
库 | Ndis.lib |
IRQL | <= DISPATCH_LEVEL |
DDI 符合性规则 | Irql_MCM_Function(ndis) |