Initialisation CoNDIS TAPI

Cette section explique comment un pilote miniport CoNDIS WAN énumère ses fonctionnalités TAPI pour les applications. Ces fonctionnalités TAPI sont les suivantes :

• Le nombre d’appareils de ligne pris en charge par le pilote miniport inclut, par exemple, un modem, une carte de télécopie et une carte ISDN.

• Les informations relatives aux lignes spécifiques incluent, par exemple, un identificateur de ligne et le nombre d’adresses de canal (numéros de téléphone) que la ligne prend en charge pour la transmission simultanée de la voix et des données.

• Les informations relatives aux adresses de canal spécifiques sur les lignes des appareils incluent, par exemple, l'identité d'un appelant (ID d'appelant) et le nombre d'appels actifs possibles.

Pour récupérer des informations sur le matériel sous-jacent, NPDROXY émet des demandes de fonctionnalités de ligne et d’adresse de canal. Autrement dit, le pilote NPDROXY interroge les fonctionnalités TAPI d’un pilote miniport CoNDIS WAN. Le pilote NPDROXY appelle la fonction NdisCoOidRequest pour interroger les fonctionnalités TAPI du pilote miniport. Dans cet appel, NDPROXY transmet une structure NDIS_OID_REQUEST. NPDROXY spécifie les éléments suivants dans NDIS_OID_REQUEST :

• Valeur NdisRequestQueryInformation dans le membre RequestType

• Identificateur d’objet (OID) qui spécifie la fonctionnalité TAPI à récupérer à partir du pilote miniport dans le membre Oid

• Mémoire tampon pour contenir les informations de capacité TAPI retournées dans le membre InformationBuffer

Toutes les requêtes envoyées à un pilote miniport CoNDIS WAN par le pilote NPDROXY peuvent être effectuées de manière synchrone ou asynchrone. Si un pilote miniport CoNDIS WAN détermine qu’il ne peut pas terminer la requête immédiatement, il peut simplement retourner NDIS_STATUS_PENDING et appeler la fonction NdisMCmOidRequestComplete à partir de sa fonction ProtocolCoOidRequest lorsqu’elle a terminé la requête.

Une fois qu’un pilote miniport CoNDIS WAN informe NDPROXY de l’enregistrement d’une nouvelle famille d’adresses comme spécifié dans l’enregistrement CoNDIS TAPI, NDPROXY interroge les OID suivants pour déterminer les fonctionnalités spécifiques au TAPI du pilote miniport CoNDIS WAN et la carte réseau du miniporteur.

• NPDROXY interroge le pilote miniport avec OID_CO_TAPI_CM_CAPS pour déterminer le nombre de lignes prises en charge par l’appareil du pilote miniport (appareil pour lequel il fournit des services TAPI). Cet OID demande également au pilote miniport d’indiquer si ces lignes ont des capacités de ligne différentes.

• NPDROXY interroge ensuite le pilote miniport avec OID_CO_TAPI_LINE_CAPS pour déterminer les fonctionnalités de téléphonie pour la ligne spécifiée. Cet OID demande également au pilote miniport d’indiquer si les adresses de cette ligne possèdent des fonctionnalités d’adresse différentes.

  • Si la requête précédente de OID_CO_TAPI_CM_CAPS a indiqué que l’appareil du pilote miniport ne prend en charge qu’une seule ligne ou si l’appareil prend en charge plusieurs lignes qui ont les mêmes fonctionnalités de ligne, NPDROXY doit interroger OID_CO_TAPI_LINE_CAPS une seule fois pour obtenir les fonctionnalités de ligne de l’appareil. Dans ce cas, les fonctionnalités de ligne retournées par le pilote miniport s’appliquent à toutes les lignes de l’appareil.
  • Si l’appareil prend en charge plusieurs lignes avec des fonctionnalités de ligne différentes, NDPROXY doit interroger OID_CO_TAPI_LINE_CAPS une fois pour chaque ligne afin d’obtenir ses fonctionnalités.

• Enfin, NPDROXY interroge le pilote miniport avec OID_CO_TAPI_ADDRESS_CAPS pour déterminer les fonctionnalités de téléphonie d’une adresse spécifiée sur une ligne spécifiée.

  • Si la requête précédente de OID_CO_TAPI_LINE_CAPS a indiqué que la ligne ne prend en charge qu'une seule adresse ou que toutes les adresses sur la ligne ont les mêmes capacités d'adresse, NDPROXY interroge OID_CO_TAPI_ADDRESS_CAPS une seule fois pour déterminer les capacités de toutes les adresses sur la ligne.
  • Si une ligne prend en charge plusieurs adresses ayant des fonctionnalités différentes, NDPROXY interroge OID_CO_TAPI_ADDRESS_CAPS une fois pour chaque adresse sur la ligne.

Le pilote NPDROXY utilise les informations obtenues avec les OID d’énumération TAPI pour effectuer les opérations suivantes :

• Créez des paramètres TAPI pour les appels TAPI suivants.

• Déterminez s’il faut accepter ou rejeter les appels TAPI entrants suivants.

• Inscrivez un ou plusieurs points d’accès au service TAPI sur lesquels recevoir des appels TAPI entrants suivants.