NdisClMakeCall, fonction (ndis.h)
NdisClMakeCall configure un appel sortant sur un vc créé par le client.
Syntaxe
NDIS_STATUS NdisClMakeCall(
[in] NDIS_HANDLE NdisVcHandle,
[in, out] PCO_CALL_PARAMETERS CallParameters,
[in, optional] NDIS_HANDLE ProtocolPartyContext,
[out, optional] PNDIS_HANDLE NdisPartyHandle
);
Paramètres
[in] NdisVcHandle
Spécifie le handle retourné par un appel précédent à NdisCoCreateVc.
[in, out] CallParameters
Pointeur vers une structure de type CO_CALL_PARAMETERS dans laquelle l’appelant a spécifié les attributs de cette connexion, tels que l’adresse de la cible pour l’appel, la latence, la bande passante et la qualité de service si le support réseau et la famille d’adresses pris en charge par le gestionnaire d’appels autorisent les spécifications QoS.
[in, optional] ProtocolPartyContext
Spécifie éventuellement un handle fourni par l’appelant dans une zone de contexte résidente dans laquelle le client conserve l’état par partie pour la partie initiale sur son vc multipoint. Ce paramètre est NULL si la valeur VC donnée ne représente pas une connexion multipoint. Pour une VV multipoint, NDIS transmet ce handle aux fonctions ProtocolClXxx du client dans tous les appels suivants qui affectent cette partie particulière.
[out, optional] NdisPartyHandle
Pointeur vers une variable fournie par l’appelant, généralement dans la zone de contexte de partie allouée par l’appelant, dans laquelle NDIS retourne un handle représentant la partie initiale à la connexion multipoint si la demande de configuration d’un appel sortant réussit. Si ProtocolPartyContext est NULL, cette variable, généralement dans la zone de contexte VC du client, est également définie sur NULL à la fin de la configuration des appels sortants.
Valeur de retour
Lorsque NdisClMakeCall retourne autre chose que NDIS_STATUS_PENDING, le client doit effectuer un appel interne à son Fonction de ProtocolClMakeCallComplete. Sinon, NDIS appelle la fonction ProtocolClMakeCallComplete du client lorsque cette opération est terminée.
Remarques
NdisClMakeCall configure les attributs d’un vc créé par le client pour un appel sortant initié par le client. Le client doit configurer la vc avec NdisCoCreateVc avant de tenter d’effectuer un appel sortant.
Un appel à NdisClMakeCall entraîne le transfert de cette requête à la fonction ProtocolCmMakeCall du gestionnaire d’appels avec laquelle le client partage le NdisVcHandledonné. La cm est chargée de valider les données données données à CallParameters . Il peut modifier ces données fournies par le client lors de la négociation avec des composants réseau pertinents et retourner différents paramètres de trafic que le client a initialement donné à NdisClMakeCall. Le client ProtocolClMakeCallComplete fonction est responsable de l’acceptation des paramètres d’appel modifiés si cela se produit ou de la suppression de l’appel si les paramètres d’appel proposés par cm sont inacceptables.
Par conséquent, les données de CallParameters doivent rester disponibles pour le gestionnaire d’appels au moins pendant la durée de la configuration des appels. Le client ne peut pas libérer cette mémoire tampon lorsque NdisClMakeCall retourne NDIS_STATUS_PENDING. Il doit différer la publication de cette ressource allouée par le client jusqu’à ce que sa fonction ProtocolClMakeCallComplete soit appelée.
Si NdisClMakeCall configure une connexion multipoint, le client établit les paramètres de trafic globalement pour la vc donnée, sauf si le support réseau sous-jacent prend en charge les paramètres de trafic par partie.
La fonction ProtocolClMakeCallComplete du client doit vérifier l’entrée Status pour NDIS_STATUS_SUCCESS avant d’utiliser un handle retourné à NdisPartyHandle. Si le gestionnaire d’appels échoue la demande pour configurer un appel sur une connexion multipoint, la valeur de cette variable fournie par le client n’est pas valide.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Pris en charge pour les pilotes NDIS 6.0 et NDIS 5.1 (voir NdisClMakeCall (NDIS 5.1)) dans Windows Vista. Pris en charge pour les pilotes NDIS 5.1 (voir NdisClMakeCall (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) |