NdisCmDispatchIncomingCall 函式（ndis.h）

發行項
02/07/2025

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

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

[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，並在通知遠端節點提供呼叫遭到拒絕之後，停用它所建立的 VC。

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

要求

要求	價值
最低支援的用戶端	支援 Windows Vista 中的 NDIS 6.0 和 NDIS 5.1 驅動程式（請參閱 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）