NdisCmDispatchIncomingCallQoSChange 函式 (ndis.h)
NdisCmDispatchIncomingCallQoSChange 通知用戶端,要求變更該用戶端作用中連線上的服務品質已透過網路接收。
語法
void NdisCmDispatchIncomingCallQoSChange(
[in] NDIS_HANDLE NdisVcHandle,
[in] PCO_CALL_PARAMETERS CallParameters
);
參數
[in] NdisVcHandle
指定要求 QoS 變更之 VC 的句柄。 呼叫管理員最初在呼叫 NdisCoCreateVc 時取得此句柄,以設定連入呼叫的這個連線,或是為其 ProtocolCoCreateVc 函式的輸入參數。
[in] CallParameters
CO_CALL_PARAMETERS 類型的結構 指標,指定遠端節點上用戶端針對此連線要求的新 QoS。
傳回值
無
備註
獨立呼叫管理員會呼叫 NdisCmDispatchIncomingCallQoSChange ,通知用戶端已收到要求來修改作用中連線上的 QoS。 這類 CM 支援使用中呼叫的動態 QoS 變更,這是視訊號通訊協定而定之 QoS 本身的功能。
當 CM 本身收到 QoS 變更的要求時,呼叫管理員會將適當修改的呼叫參數傳遞至 NdisCmActivateVc,因此基礎迷你埠驅動程式也會收到建議 QoS 變更的通知。 假設基礎迷你埠驅動程式接受已變更的呼叫參數,CM 接著會呼叫 NdisCmDispatchIncomingCallQoSChange。
呼叫 NdisCmDispatchIncomingCallQoSChange 會導致 NDIS 呼叫用戶端的 ProtocolClIncomingQoSChange 函式 。 用戶端會接受對 VC 呼叫參數的建議修改,但可能更新它針對 VC 的 QoS 維護的任何狀態,以及傳回控件。 否則,用戶端會卸除呼叫來拒絕建議的 QoS 變更。
只有向 NDIS 註冊為通訊協定驅動程式的獨立呼叫管理員,才能呼叫 NdisCmDispatchIncomingCallQoSChange。 提供整合式呼叫管理支持的連線導向迷你埠驅動程式會改為呼叫 NdisMCmDispatchIncomingCallQoSChange 。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 支援 NDIS 6.0 和 NDIS 5.1 驅動程式 (請參閱 Windows Vista 中的 NdisCmDispatchIncomingCallQoSChange (NDIS 5.1) ) 。 支援 NDIS 5.1 驅動程式 (請參閱 Windows XP 中的 NdisCmDispatchIncomingCallQoSChange (NDIS 5.1) ) 。 |
目標平台 | 桌面 |
標頭 | ndis.h (包括 Ndis.h) |
程式庫 | Ndis.lib |
IRQL | <= DISPATCH_LEVEL |
DDI 合規性規則 | Irql_CallManager_Function (ndis) |