NdisCmDispatchIncomingCall 函式 (ndis.h)

發行項
02/29/2024

NdisCmDispatchIncomingCall 會在先前由該用戶端註冊的 SAP 上通知用戶端傳入呼叫。

語法

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

參數

[in] NdisSapHandle

指定識別 SAP 的句柄。當用戶端最初呼叫 NdisClRegisterSap 時，NDIS 會設定此句柄，而呼叫管理員原本會取得此句柄做為其輸入參數 ProtocolCmRegisterSap 函式。

[in] NdisVcHandle

指定識別 VC 的句柄，當呼叫管理員處理導向至此已註冊 SAP 的傳入呼叫供應專案時，使用 NdisCoCreateVc 建立。

[in] CallParameters

CO_CALL_PARAMETERS 類型的結構指標，指定 VC 的流量和媒體參數。

傳回值

當 NdisCmDispatchIncomingCall 傳回NDIS_STATUS_PENDING以外的任何專案時，呼叫管理員應該對其進行內部呼叫 ProtocolCmIncomingCallComplete 函式。否則，NDIS 會在完成此作業時呼叫 CM 的 ProtocolCmIncomingCallComplete 函式 。

備註

在呼叫 NdisCmDispatchIncomingCall 之前，獨立呼叫管理員已經完成下列動作：

已識別先前由特定客戶端註冊的目標 SAP，以實際進行呼叫 (要求，要求) 透過網路接收的連線
使用 NdisCoCreateVc 建立來電的 VC
可能透過網路交涉有關可接受的呼叫參數，或接受從遠端節點傳送的呼叫參數
使用 NdisCmActivateVc 啟動 VC，導致基礎迷你埠驅動程式自行準備好在 VC 上與交涉或已接受的呼叫參數一致進行傳輸

CM 對 NdisCmDispatchIncomingCall 的呼叫會導致 NDIS 呼叫用戶端的 ProtocolClIncomingCall 函式，用戶端在其中接受或拒絕要求的連線。決定是否接受連線之後，用戶端會呼叫 NdisClIncomingCallComplete，接著會呼叫 CM 的 ProtocolCmIncomingCallComplete 函式。如果用戶端接受呼叫，CM 接下來會呼叫 NdisCmDispatchCallConnected。否則，它會停用 (，而且可能會刪除) 建立的 VC，然後通知遠端節點，指出已拒絕提供的呼叫。

只有向 NDIS 註冊為通訊協定驅動程式的獨立呼叫管理員，才能呼叫 NdisCmDispatchIncomingCall。提供整合式呼叫管理支援的連線導向迷你埠驅動程式會改為呼叫 NdisMCmDispatchIncomingCall 。

規格需求

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