PROTOCOL_CL_INCOMING_CALL回呼函式 (ndis.h)

發行項
02/29/2024

ProtocolClIncomingCall 函式是由接受連入呼叫的連接導向用戶端使用。這類客戶端必須具有 ProtocolClIncomingCall 函式。否則，這類通訊協定驅動程式的已註冊 ProtocolClIncomingCall 函式可以直接傳回NDIS_STATUS_NOT_SUPPORTED。

注意您必須使用 PROTOCOL_CL_INCOMING_CALL 類型來宣告函式。如需詳細資訊，請參閱下列範例一節。

語法

PROTOCOL_CL_INCOMING_CALL ProtocolClIncomingCall;

NDIS_STATUS ProtocolClIncomingCall(
  [in]      NDIS_HANDLE ProtocolSapContext,
  [in]      NDIS_HANDLE ProtocolVcContext,
  [in, out] PCO_CALL_PARAMETERS CallParameters
)
{...}

參數

[in] ProtocolSapContext

指定客戶端在註冊 SAP 時原本提供的句柄，而呼叫管理員會比對這個來電供應專案。

[in] ProtocolVcContext

指定用戶端每個 VC 內容區域的句柄，先前由其 ProtocolCoCreateVc 函式傳回至 NDIS。

[in, out] CallParameters

緩衝區的指標，格式化為 CO_CALL_PARAMETERS 結構，其中包含這個所提供呼叫的呼叫參數。

傳回值

ProtocolClIncomingCall 可以傳回下列其中一個狀態代碼：

傳回碼	Description
NDIS_STATUS_SUCCESS	用戶端已接受來電供應專案。
NDIS_STATUS_PENDING	用戶端會以異步方式處理此要求，而且會呼叫當關閉作業完成時，NdisClIncomingCallComplete 函式。
NDIS_STATUS_XXX	用戶端因為某些驅動程序決定的原因而拒絕來電供應專案。

備註

對 ProtocolClIncomingCall 的呼叫表示呼叫管理員已透過網路收到來自訊號對等的要求，以與此用戶端建立連線。也就是說，設定這類連線的要求已導向至先前由此用戶端向呼叫管理員註冊的SAP。

根據呼叫管理員支援的訊號通訊協定， ProtocolClIncomingCall 可以在交涉接受來電供應專案和/或呼叫管理員支援 QoS 的程式中修改流量參數。如果呼叫管理員支援 QoS， 則 CallParameters 的服務質量規格。如果用戶端接受提供的呼叫，客戶端應該從這個緩衝結構複製後續需要的任何資訊。

假設呼叫管理員發現用戶端的修改，如果有任何可接受的 NDIS，則下次呼叫用戶端的 ProtocolClIncomingCallConnected 函式時，當傳輸可能發生在作用中的 VC 上，代表原本起始呼叫供應專案之遠端節點上客戶端的連線。如果客戶端傳回無法接受的已修改呼叫參數，則呼叫管理員可以終止為此供應專案建立的 VC，因而導致對用戶端的呼叫 ProtocolClIncomingCloseCall ，然後改為 ProtocolCoDeleteVc 函式。

例子

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

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

PROTOCOL_CL_INCOMING_CALL MyClIncomingCall;

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

_Use_decl_annotations_
NDIS_STATUS
 MyClIncomingCall(
    NDIS_HANDLE  ProtocolSapContext,
    NDIS_HANDLE  ProtocolVcContext,
    PCO_CALL_PARAMETERS  CallParameters
    )
  {...}

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

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

規格需求

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