NdisClGetProtocolVcContextFromTapiCallId, fonction (ndis.h)

  • Article

NdisClGetProtocolVcContextFromTapiCallId récupère le contexte client pour une connexion virtuelle (VC) 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 un vc particulier. 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é à l’appelant qui reçoit un handle vers le contexte client pour le vc. Le client a fourni ce contexte à NDIS lors du retour de son gestionnaire ProtocolCoCreateVc .

Valeur retournée

Retourne l’une des valeurs status suivantes :

Code de retour Description
NDIS_STATUS_SUCCESS
 NDIS a correctement récupéré le handle dans le contexte vc client pour le vc identifié par la chaîne d’ID d’appel TAPI.
NDIS_STATUS_FAILURE
 La tentative de récupération du handle dans le contexte vc client a échoué.

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 le vc. Le client peut ensuite présenter cet identificateur sous la forme d’une chaîne Unicode à NdisClGetProtocolVcContextFromTapiCallId pour récupérer son contexte pour le 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 passe 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 au 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 le vc.

Pour plus d’informations, consultez la structure UNICODE_STRING.

Configuration requise

Condition requise Valeur
Client minimal 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 Desktop (Expérience utilisateur)
En-tête ndis.h (inclure Ndis.h)
Bibliothèque Ndis.lib
IRQL DISPATCH_LEVEL
Règles de conformité DDI Irql_Protocol_Driver_Function(ndis)

Voir aussi

NdisCoCreateVc

NdisCoGetTapiCallId

UNICODE_STRING