PROTOCOL_CL_INCOMING_CALL_QOS_CHANGE回呼函式 (ndis.h)

ProtocolClIncomingCallQoSChange 函式是由支援動態服務品質之網路上的連線導向用戶端使用。 這類客戶端必須具有 ProtocolClIncomingCallQoSChange 函式 。 否則，這類通訊協定驅動程式的已註冊 ProtocolClIncomingCallQoSChange 函式可以直接傳回控制權。

語法

PROTOCOL_CL_INCOMING_CALL_QOS_CHANGE ProtocolClIncomingCallQosChange;

void ProtocolClIncomingCallQosChange(
  [in] NDIS_HANDLE ProtocolVcContext,
  [in] PCO_CALL_PARAMETERS CallParameters
)
{...}

參數

[in] ProtocolVcContext

針對要求修改服務品質的要求已透過網路傳入的 VC，指定用戶端每個 VC 內容區域的句柄。

[in] CallParameters

緩衝區的指標，格式化為包含新 QoS 規格 的 CO_CALL_PARAMETERS 結構。

傳回值

無

備註

對 ProtocolClIncomingCallQoSChange 的呼叫會向用戶端指出遠端對等已在此呼叫上要求服務質量變更。 CallParameters 會說明新的服務品質。 用戶端只要傳回控制權即可接受要求的變更。 否則，
ProtocolClIncomingCallQoSChange 應該使用 NdisCloseCall 卸除呼叫。

例子

若要定義 ProtocolClIncomingCallQoSChange 函式，您必須先提供函式宣告來識別您要定義的函式類型。 Windows 提供一組驅動程式的函式類型。 使用函式類型宣告函式有助於 驅動程式的程式代碼分析、 靜態驅動程序驗證器 (SDV) ，以及其他驗證工具會尋找錯誤，而且這是撰寫 Windows 操作系統驅動程式的需求。

例如，若要定義名為 「 MyClIncomingCallQoSChange」 的 ProtocolClIncomingCallQoSChange 函式，請使用 PROTOCOL_CL_INCOMING_CALL_QOS_CHANGE 類型，如下列程式代碼範例所示：

PROTOCOL_CL_INCOMING_CALL_QOS_CHANGE MyClIncomingCallQoSChange;

然後，實作您的函式，如下所示：

_Use_decl_annotations_
VOID
 MyClIncomingCallQoSChange(
    NDIS_HANDLE  ProtocolVcContext,
    PCO_CALL_PARAMETERS  CallParameters
    )
  {...}

PROTOCOL_CL_INCOMING_CALL_QOS_CHANGE函式類型定義於 Ndis.h 頭檔中。 若要在執行程式代碼分析工具時更精確地識別錯誤，請務必將 Use_decl_annotations 註釋新增至函式定義。 Use_decl_annotations註釋可確保使用頭檔中套用至PROTOCOL_CL_INCOMING_CALL_QOS_CHANGE函式類型的批註。 如需函式宣告需求的詳細資訊，請參閱 使用 NDIS 驅動程式的函式角色類型來宣告函式。

如需 Use_decl_annotations的詳細資訊，請參閱 標註函式行為。

規格需求

需求	值
最低支援的用戶端	支援 NDIS 6.0 和 NDIS 5.1 驅動程式 (請參閱 Windows Vista 中的 ProtocolClIncomingCallQoSChange (NDIS 5.1) ) 。 支援 NDIS 5.1 驅動程式 (請參閱 Windows XP 中的 ProtocolClIncomingCallQoSChange (NDIS 5.1) ) 。
目標平台	Windows
標頭	ndis.h (包括 Ndis.h)
IRQL	<= DISPATCH_LEVEL

另請參閱

NdisCloseCall

NdisClModifyCallQoS

ProtocolCmModifyCallQoS