Funzione NdisClIncomingCallComplete (ndis.h)

Articolo
02/29/2024

NdisClIncomingCallComplete restituisce l'accettazione o il rifiuto di un client di una chiamata in arrivo offerta, per cui la funzione ProtocolClIncomingCall del client ha restituito in precedenza NDIS_STATUS_PENDING.

Sintassi

void NdisClIncomingCallComplete(
  [in] NDIS_STATUS         Status,
  [in] NDIS_HANDLE         NdisVcHandle,
  [in] PCO_CALL_PARAMETERS CallParameters
);

Parametri

[in] Status

È impostato su NDIS_STATUS_SUCCESS se il client accetta la chiamata offerta. In caso contrario, questo parametro può essere impostato su qualsiasi NDIS_STATUS_XXX tranne NDIS_STATUS_PENDING per indicare il motivo determinato dal client per rifiutare la chiamata.

[in] NdisVcHandle

Specifica l'handle per il vc creato dal gestore chiamate per rappresentare la chiamata in arrivo. Il client ha ottenuto questo handle dallo stato per VC designato da ProtocolVcContext passato come parametro di input al relativo Funzione ProtocolClIncomingCall .

[in] CallParameters

Puntatore a una struttura di tipo CO_CALL_PARAMETERS, specificando i parametri di chiamata per la chiamata in ingresso.

Valore restituito

nessuno

Osservazioni

Se la funzione ProtocolClIncomingCall di un client restituisce NDIS_STATUS_PENDING per una chiamata offerta in ingresso in un determinato SAP, registrato in precedenza dal client con NdisClRegisterSap, il client deve successivamente chiamare NdisClIncomingCallComplete per indicare se accetta o rifiuta la chiamata offerta.

Prima di chiamare NdisClIncomingCallComplete, tale client può negoziare con il gestore chiamate chiamando NdisClModifyCallQoS una o più volte fino a quando entrambi i driver raggiungono un accordo su una qualità accettabile del servizio per la chiamata in arrivo o il client determina che deve rifiutare la chiamata offerta perché i suoi tentativi di modificare il QoS raggiungono un limite determinato dal client senza ottenere un contratto.

Se il client ha modificato i parametri di chiamata passati alla relativa funzione ProtocolClIncomingCall , deve impostare il membro Flags nella struttura CO_CALL_PARAMETERS con CALL_PARAMETERS_CHANGED quando passa queste modifiche a NdisClIncomingCallComplete. A seconda che il gestore chiamate accetti o rifiuta le modifiche proposte dal client ai parametri di chiamata, NDIS chiama successivamente il client ProtocolClCallConnected o la relativa funzione ProtocolClIncomingCloseCall , rispettivamente.

Una chiamata a NdisClIncomingCallComplete fa sì che NDIS chiami il cm Funzione ProtocolCmIncomingCallComplete . NDIS passa i parametri forniti dal client di NdisClIncomingCallComplete come parametri di input a ProtocolCmIncomingCallComplete.

Se un client rifiuta una chiamata offerta impostando Status su un valore diverso da NDIS_STATUS_SUCCESS, il client deve considerare il puntatore CallParameters non valido non appena viene eseguita la chiamata a NdisClIncomingCallComplete .

Requisiti

Requisito	Valore
Client minimo supportato	Supportato per i driver NDIS 6.0 e NDIS 5.1 (vedere NdisClIncomingCallComplete (NDIS 5.1)) in Windows Vista. Supportato per i driver NDIS 5.1 (vedere NdisClIncomingCallComplete (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_Protocol_Driver_Function(ndis)