Funzione NdisCmDispatchIncomingCall (ndis.h)

Articolo
08/07/2023

NdisCmDispatchIncomingCall informa il client di una chiamata in arrivo 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 ha originariamente chiamato NdisClRegisterSap e 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 vc, 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 i parametri del traffico e del supporto per il 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.

Commenti

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 sulla rete
È stato creato un vc per la chiamata in ingresso con NdisCoCreateVc
Possibilmente negoziata sui parametri di chiamata accettabili in rete o accettati i parametri di chiamata inviati dal nodo remoto
Attivato vc con NdisCmActivateVc, causando il driver miniport sottostante per prepararsi per i trasferimenti sul vc in accordo con i parametri di chiamata negoziati o accettati

La chiamata di 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 quindi 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 invece il supporto integrato per la gestione delle chiamate NdisMCmDispatchIncomingCall .

Requisiti

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)