NdisClGetProtocolVcContextFromTapiCallId, fonction (ndis.h)
NdisClGetProtocolVcContextFromTapiCallId récupère le contexte client d’une connexion virtuelle identifiée par une chaîne d’ID d’appel TAPI.
Syntaxe
NDIS_STATUS NdisClGetProtocolVcContextFromTapiCallId(
[in] UNICODE_STRING TapiCallId,
[out] PNDIS_HANDLE ProtocolVcContext
);
Paramètres
[in] TapiCallId
Chaîne Unicode qui identifie une vc particulière. Cette chaîne est la version Unicode d’un identificateur de chaîne précédemment retourné par la fonction NdisCoGetTapiCallID.
[out] ProtocolVcContext
Pointeur vers un NDIS_HANDLE alloué par l’appelant qui reçoit un handle vers le contexte client pour la vc. Le client a fourni ce contexte à NDIS à partir de son gestionnaire ProtocolCoCreateVc.
Valeur de retour
Retourne l’une des valeurs d’état suivantes :
| Retourner le code | Description |
|---|---|
|
NDIS a récupéré avec succès le handle dans le contexte VC client pour la vc identifiée par la chaîne d’ID d’appel TAPI. |
|
Échec de la tentative de récupération du handle dans le contexte VC client. |
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 un identificateur de chaîne pour la vc. Le client peut ensuite présenter cet identificateur en tant que chaîne Unicode pour NdisClGetProtocolVcContextFromTapiCallId pour récupérer son contexte pour 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 correct pour la vc.
Pour plus d’informations, consultez la structure UNICODE_STRING.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Pris en charge pour les pilotes NDIS 6.0 et NDIS 5.1 (voir NdisClGetProtocolVcContextFromTapiCallId (NDIS 5.1)) dans Windows Vista. Pris en charge pour les pilotes NDIS 5.1 (voir NdisClGetProtocolVcContextFromTapiCallId (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) |