NdisClModifyCallQoS 函式 (ndis.h)

發行項
02/26/2024

NdisClModifyCallQoS 要求連線服務質量變更。

語法

NDIS_STATUS NdisClModifyCallQoS(
  [in] NDIS_HANDLE         NdisVcHandle,
  [in] PCO_CALL_PARAMETERS CallParameters
);

參數

[in] NdisVcHandle

指定用戶端想要修改 QoS 之 VC 的句柄。用戶端最初藉由呼叫 NdisCoCreateVc 來取得此句柄，而且最近從每個 VC 狀態區域擷取此句柄。

[in] CallParameters

型別CO_CALL_PARAMETERS結構的指標，指定呼叫端所要求的新 QoS。

傳回值

當 NdisClModifyCallQoS 傳回NDIS_STATUS_PENDING以外的任何專案時，客戶端應該對其進行內部呼叫 ProtocolClModifyCallQoSComplete 函式。否則，NDIS 會在完成此作業時呼叫用戶端的 ProtocolClModifyCallQoSComplete 函式。

備註

呼叫 NdisClModifyCallQoS 會導致 NDIS 呼叫 CM 的 ProtocolCmModifyCallQoS 函式，接著會呼叫 NdisCmActivateVc ，以在可以進行要求的 QoS 變更時通知基礎迷你埠驅動程式變更呼叫參數。

如果呼叫管理員不接受用戶端提議的 QoS 變更，則用戶端可以繼續使用未變更的 QoS 進行呼叫，也可以終止呼叫。如果客戶端和呼叫管理員無法同意特定呼叫的 QoS，則 VC 的建立者必須負責起始 VC 的終止。

規格需求

需求	值
最低支援的用戶端	支援 NDIS 6.0 和 NDIS 5.1 驅動程式 (請參閱 Windows Vista 中的 NdisClModifyCallQoS (NDIS 5.1) ) 。支援 NDIS 5.1 驅動程式 (請參閱 Windows XP 中的 NdisClModifyCallQoS (NDIS 5.1) ) 。
目標平台	桌面
標頭	ndis.h (包括 Ndis.h)
程式庫	Ndis.lib
IRQL	<= DISPATCH_LEVEL
DDI 合規性規則	Irql_Protocol_Driver_Function (ndis)