NdisClIncomingCallComplete, fonction (ndis.h)
NdisClIncomingCallComplete retourne l’acceptation ou le rejet d’un appel entrant proposé, pour lequel la fonction ProtocolClIncomingCall du client a précédemment retourné NDIS_STATUS_PENDING.
Syntaxe
void NdisClIncomingCallComplete(
[in] NDIS_STATUS Status,
[in] NDIS_HANDLE NdisVcHandle,
[in] PCO_CALL_PARAMETERS CallParameters
);
Paramètres
[in] Status
Est défini sur NDIS_STATUS_SUCCESS si le client accepte l’appel proposé. Dans le cas contraire, ce paramètre peut être défini sur n’importe quel NDIS_STATUS_XXX sauf NDIS_STATUS_PENDING pour indiquer la raison déterminée par le client de rejeter l’appel.
[in] NdisVcHandle
Spécifie le handle de la vc créée par le gestionnaire d’appels pour représenter l’appel entrant. Le client a obtenu ce handle à partir de son état par VC désigné par l'ProtocolVcContext passé en tant que paramètre d’entrée à son ProtocolClIncomingCall fonction.
[in] CallParameters
Pointeur vers une structure de type CO_CALL_PARAMETERS, en spécifiant les paramètres d’appel de l’appel entrant.
Valeur de retour
Aucun
Remarques
Si la fonction ProtocolClIncomingCall d’un client retourne NDIS_STATUS_PENDING pour un appel proposé entrant sur un SAP particulier, précédemment inscrit par le client avec NdisClRegisterSap, le client doit ensuite appeler NdisClIncomingCallComplete pour indiquer s’il accepte ou refuse l’appel proposé.
Avant d’appeler NdisClIncomingCallComplete, un tel client peut négocier avec le gestionnaire d’appels en appelant NdisClModifyCallQoS une ou plusieurs fois jusqu’à ce que les deux pilotes atteignent un accord sur une qualité de service acceptable pour l’appel entrant ou que le client détermine qu’il doit rejeter l’appel proposé, car ses tentatives de modification de la QoS atteignent une limite déterminée par le client sans aboutir à un accord.
Si le client a modifié les paramètres d’appel passés à sa fonction ProtocolClIncomingCall, il doit définir le membre Flags dans la structure CO_CALL_PARAMETERS avec CALL_PARAMETERS_CHANGED lorsqu’il transmet ces modifications à NdisClIncomingCallComplete. Selon que le gestionnaire d’appels accepte ou rejette les modifications proposées par le client pour les paramètres d’appel, NDIS appelle par la suite soit le client ProtocolClCallConnected fonction ou son ProtocolClIncomingCloseCall fonction, respectivement.
Un appel à NdisClIncomingCallComplete entraîne l’appel de NDIS du CM ProtocolCmIncomingCallComplete fonction. NDIS transmet les paramètres fournis par le client de NdisClIncomingCallComplete en tant que paramètres d’entrée pour ProtocolCmIncomingCallComplete.
Si un client rejette un appel proposé en définissant Status sur une autre valeur que NDIS_STATUS_SUCCESS, le client doit prendre en compte le pointeur CallParameters non valide dès son appel à NdisClIncomingCallComplete se produit.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Pris en charge pour les pilotes NDIS 6.0 et NDIS 5.1 (voir NdisClIncomingCallComplete (NDIS 5.1)) dans Windows Vista. Pris en charge pour les pilotes NDIS 5.1 (voir NdisClIncomingCallComplete (NDIS 5.1)) dans Windows XP. |
| plateforme cible | Bureau |
| d’en-tête | ndis.h (include Ndis.h) |
| bibliothèque | Ndis.lib |
| IRQL | <= DISPATCH_LEVEL |
| règles de conformité DDI | Irql_Protocol_Driver_Function(ndis) |