NdisMCmDispatchIncomingCall 宏 (ndis.h)

發行項
02/29/2024

NdisMCmDispatchIncomingCall 會通知用戶端該用戶端先前向 MCM 驅動程序註冊之 SAP 上的傳入呼叫。

語法

void NdisMCmDispatchIncomingCall(
   _SH_,
   _VH_,
   _CP_
);

參數

_SH_

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

_VH_

指定當 MCM 驅動程式處理導向至此已註冊 SAP 的連入呼叫供應專案時，使用 NdisMCmCreateVc 建立的識別 VC 的句柄。

_CP_

CO_CALL_PARAMETERS 型別結構的指標，指定 VC 的呼叫和媒體參數。

傳回值

無

備註

呼叫 NdisMCmDispatchIncomingCall 之前，MCM 驅動程序已經完成下列動作：

已識別先前由特定客戶端註冊的目標 SAP，以實際進行呼叫 (要求，要求) 透過網路接收的連線
使用 NdisMCmCreateVc 建立連入通話的 VC
可能透過網路交涉有關可接受的呼叫參數，或接受從遠端節點傳送的呼叫參數
使用 NdisMCmActivateVc 啟動 VC，通知 NDIS 它已準備好與交涉或接受的呼叫參數一致，在 VC 上進行傳輸

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

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

規格需求

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