Macro NdisMCmDispatchIncomingCall (ndis.h)

Articolo
03/05/2024

NdisMCmDispatchIncomingCall informa il client di una chiamata in arrivo su un SAP registrato in precedenza da tale client con il driver MCM.

Sintassi

void NdisMCmDispatchIncomingCall(
   _SH_,
   _VH_,
   _CP_
);

Parametri

_SH_

Specifica l'handle che identifica SAP. NDIS configura questo handle quando il client ha originariamente chiamato NdisClRegisterSap e il driver MCM ha ottenuto questo handle come parametro di input per il relativo Funzione ProtocolCmRegisterSap .

_VH_

Specifica l'handle che identifica il vc, creato con NdisMCmCreateVc quando il driver MCM elabora l'offerta di chiamata in ingresso indirizzata a questo SAP registrato.

_CP_

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

Valore restituito

nessuno

Osservazioni

Prima di chiamare NdisMCmDispatchIncomingCall, un driver MCM 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 NdisMCmCreateVc
Possibilmente negoziata sui parametri di chiamata accettabili in rete o accettati i parametri di chiamata inviati dal nodo remoto
Attivato vc con NdisMCmActivateVc per notificare a NDIS che è pronto per i trasferimenti nel vc in accordo con i parametri di chiamata negoziati o accettati

La chiamata del driver MCM a NdisMCmDispatchIncomingCall 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 la funzione ProtocolCmIncomingCallComplete del driver MCM. Se il client ha accettato la chiamata, il driver MCM chiama successivamente NdisMCmDispatchCallConnected. In caso contrario, disattiva (ed eventualmente elimina) il vc creato, dopo aver informato il nodo remoto che la chiamata offerta è stata rifiutata.

Solo i driver miniport orientati alla connessione che forniscono il supporto integrato per la gestione delle chiamate NdisMCmDispatchIncomingCall. I gestori chiamate autonomi, che si registrano con NDIS come driver di protocollo, chiamano invece NdisCmDispatchIncomingCall .

Requisiti

Requisito	Valore
Client minimo supportato	Supportato per i driver NDIS 6.0 e NDIS 5.1 (vedere NdisMCmDispatchIncomingCall (NDIS 5.1)) in Windows Vista. Supportato per i driver NDIS 5.1 (vedere NdisMCmDispatchIncomingCall (NDIS 5.1)) in Windows XP.
Piattaforma di destinazione	Desktop
Intestazione	ndis.h (include Ndis.h)
IRQL	<= DISPATCH_LEVEL
Regole di conformità DDI	Irql_MCM_Function(ndis)