Funzione NdisCmDispatchIncomingCall (ndis.h)

Articolo
02/07/2025

NdisCmDispatchIncomingCall informa il client di una chiamata in ingresso su un SAP registrato in precedenza da tale client.

Sintassi

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

Parametri

[in] NdisSapHandle

Specifica l'handle che identifica SAP. NDIS configura questo handle quando il client originariamente denominato NdisClRegisterSape il gestore chiamate ha originariamente ottenuto questo handle come parametro di input per il relativo funzione ProtocolCmRegisterSap.

[in] NdisVcHandle

Specifica l'handle che identifica il vco, creato con NdisCoCreateVc quando il gestore chiamate elabora l'offerta di chiamata in ingresso indirizzata a questo SAP registrato.

[in] CallParameters

Puntatore a una struttura di tipo CO_CALL_PARAMETERS che specifica il traffico e i parametri multimediali per vc.

Valore restituito

Quando NdisCmDispatchIncomingCall restituisce qualsiasi valore diverso da NDIS_STATUS_PENDING, il gestore chiamate deve effettuare una chiamata interna alla relativa funzione ProtocolCmIncomingCallComplete. In caso contrario, NDIS chiama la funzione ProtocolCmIncomingCallComplete di CM al termine dell'operazione.

Osservazioni

Prima di chiamare NdisCmDispatchIncomingCall, un gestore chiamate autonomo ha già eseguito le operazioni seguenti:

Identificato sap di destinazione, registrato in precedenza da un determinato client, per la chiamata (in realtà, una richiesta di stabilire una connessione) ricevuta in rete
Creazione di un vc per la chiamata in ingresso con NdisCoCreateVc
È possibile negoziare i parametri di chiamata accettabili in rete o accettare i parametri di chiamata inviati dal nodo remoto
Attivato il vc con NdisCmActivateVc, causando il driver miniport sottostante di prepararsi per i trasferimenti sul VC in accordo con i parametri di chiamata negoziati o accettati

La chiamata del cm a NdisCmDispatchIncomingCall fa sì che NDIS chiami la funzione ProtocolClIncomingCall del client, all'interno della quale il client accetta o rifiuta la connessione richiesta. Dopo aver deciso se accettare la connessione, il client chiama NdisClIncomingCallComplete, che, a sua volta, chiama il cm funzione ProtocolCmIncomingCallComplete. Se il client ha accettato la chiamata, cm chiama NdisCmDispatchCallConnected. In caso contrario, disattiva (ed eventualmente elimina) il vc creato, dopo aver informato il nodo remoto che la chiamata offerta è stata rifiutata.

Solo i gestori chiamate autonomi, che si registrano con NDIS come driver di protocollo, possono chiamare NdisCmDispatchIncomingCall. Driver miniport orientati alla connessione che forniscono una chiamata integrata di gestione delle chiamate NdisMCmDispatchIncomingCall.

Fabbisogno

Requisito	Valore
client minimo supportato	Supportato per i driver NDIS 6.0 e NDIS 5.1 (vedere NdisCmDispatchIncomingCall (NDIS 5.1) in Windows Vista. Supportato per i driver NDIS 5.1 (vedere NdisCmDispatchIncomingCall (NDIS 5.1)) in Windows XP.
piattaforma di destinazione	Desktop
intestazione	ndis.h (include Ndis.h)
libreria	Ndis.lib
IRQL	<= DISPATCH_LEVEL
regole di conformità DDI	Irql_CallManager_Function(ndis)