NdisCoGetTapiCallId, fonction (ndis.h)
NdisCoGetTapiCallId récupère une chaîne que les applications TAPI peuvent utiliser pour identifier une connexion virtuelle NDIS (VC).
Syntaxe
NDIS_STATUS NdisCoGetTapiCallId(
[in] NDIS_HANDLE NdisVcHandle,
[in, out] PVAR_STRING TapiCallId
);
Paramètres
[in] NdisVcHandle
Spécifie le handle NDIS dans le vc. Ce handle a été fourni par NDIS lorsque la vc a été créée à l’origine avec la fonction NdisCoCreateVc.
[in, out] TapiCallId
Pointeur vers une mémoire tampon allouée par l’appelant qui reçoit une structure de données de type VAR_STRING. Une fois le retour réussi, cette structure décrit une chaîne que les applications TAPI peuvent utiliser pour identifier la vc.
Valeur de retour
Retourne l’une des valeurs d’état suivantes :
| Retourner le code | Description |
|---|---|
|
NDIS a correctement retourné un identificateur de chaîne pour le vc. |
|
La ulTotalSize membre de la structure VAR_STRING spécifie que la taille de la mémoire tampon n’est pas suffisamment grande pour contenir la chaîne qui identifie le vc. NdisCoGetTapiCallId définit le membre ulNeededSize de la structure VAR_STRING sur la taille requise en octets. |
|
Handle de la vc spécifiée par NdisVcHandle n’est pas valide. |
Remarques
Supposons qu’un gestionnaire d’appels appelle NdisCoCreateVc pour créer un vc pour un appel TAPI. NDIS fournit à son tour le handle au vc à un client. Le client transmet ce handle VC dans un appel à la fonction NdisCoGetTapiCallId pour récupérer une chaîne qui identifie la vc. Le client peut transmettre cet identificateur de chaîne à une application TAPI pour identifier la vc.
Le client crée un contexte pour chaque vc qu’il gère. Le client utilise NdisCoGetTapiCallId pour récupérer un identificateur de chaîne pour chaque vc. Le client transmet chaque identificateur de chaîne à une application TAPI pour identifier chaque vc. Plus tard, si une application TAPI transmet l’un de ces identificateurs de chaîne au client dans une opération liée à la vc, le client doit passer cet identificateur de chaîne en tant que chaîne Unicode dans un appel à NdisClGetProtocolVcContextFromTapiCallId pour récupérer le contexte approprié pour la vc.
Pour plus d’informations sur la structure VAR_STRING, consultez objets TAPI.