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 se composent des éléments suivants :
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 un 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.
Informations pour des adresses de canal spécifiques sur des lignes d’appareils : les informations d’adresse incluent, par exemple, l’identité d’un appelant (ID de l’appelant) et le nombre d’appels actifs possibles.
Pour récupérer des informations sur le matériel sous-jacent, NDPROXY émet des demandes pour les fonctionnalités d’adresse de ligne et de canal. Autrement dit, le pilote NDPROXY interroge les fonctionnalités TAPI d’un pilote de miniport CoNDIS WAN. Le pilote NDPROXY appelle la fonction NdisCoOidRequest pour interroger les fonctionnalités TAPI du pilote miniport. Dans cet appel, NDPROXY passe une structure NDIS_OID_REQUEST. NDPROXY spécifie les éléments suivants dans NDIS_OID_REQUEST :
Valeur NdisRequestQueryInformation dans le membre RequestType
Identificateur d’objet (OID) qui spécifie la capacité 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 de miniport CoNDIS WAN par le pilote NDPROXY 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 de miniport CoNDIS WAN a informé NDPROXY de l’inscription d’une nouvelle famille d’adresses comme spécifié dans l’inscription coNDIS TAPI, NDPROXY interroge les OID suivants pour déterminer les fonctionnalités spécifiques à TAPI du pilote de miniport CoNDIS WAN et de la carte réseau du pilote miniport.
NDPROXY 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 (l’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.
NDPROXY 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 ont des fonctionnalités d’adresse différentes.
- Si la requête précédente de OID_CO_TAPI_CM_CAPS 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, NDPROXY ne doit interroger OID_CO_TAPI_LINE_CAPS qu’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 dissemblables, NDPROXY doit interroger OID_CO_TAPI_LINE_CAPS une fois pour chaque ligne pour obtenir les fonctionnalités de ligne de chaque ligne.
Enfin, NDPROXY 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 indiquait que la ligne ne prend en charge qu’une seule adresse ou que toutes les adresses de la ligne ont les mêmes fonctionnalités d’adresse, NDPROXY n’OID_CO_TAPI_ADDRESS_CAPS qu’une seule fois pour déterminer les fonctionnalités de toutes les adresses sur la ligne.
- Si une ligne prend en charge plusieurs adresses qui ont des fonctionnalités différentes, les requêtes NDPROXY OID_CO_TAPI_ADDRESS_CAPS une fois pour chaque adresse sur la ligne.
Le pilote NDPROXY 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 (SAP) sur lesquels recevoir les appels TAPI entrants suivants.