PROTOCOL_CL_CALL_CONNECTED回呼函式 (ndis.h)

發行項
02/26/2024

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

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

語法

PROTOCOL_CL_CALL_CONNECTED ProtocolClCallConnected;

void ProtocolClCallConnected(
  [in] NDIS_HANDLE ProtocolVcContext
)
{...}

參數

[in] ProtocolVcContext

指定用戶端每個 VC 內容區域的句柄。用戶端原本會從其 ProtocolCoCreateVc 函式將此句柄傳回給 NDIS。

傳回值

無

備註

呼叫 ProtocolClCallConnected 時，呼叫管理員已成功在用戶端的 ProtocolClIncomingCall 函式先前接受的連入呼叫供應專案上完成最終交握，該函式已在 ProtocolVcContext 上設定此連線的呼叫參數。

對 ProtocolClCallConnected 的呼叫表示，無論是傳入或傳出，現在都可以在 VC 上完成數據傳輸。 ProtocolClCallConnected 應該確保用戶端已準備好在 VC 上進行或接受傳輸，再傳回控制權。

例子

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

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

PROTOCOL_CL_CALL_CONNECTED MyClCallConnected;

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

_Use_decl_annotations_
VOID
 MyClCallConnected(
    NDIS_HANDLE  ProtocolVcContext
    )
  {...}

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

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

規格需求

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