NdisClGetProtocolVcContextFromTapiCallId, fonction (ndis.h)

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 :

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

Voir aussi

NdisCoCreateVc

NdisCoGetTapiCallId

UNICODE_STRING