OID_CO_TAPI_LINE_CAPS

L’OID OID_CO_TAPI_LINE_CAPS demande à un gestionnaire d’appels ou à un pilote MCM (Miniport Call Manager) intégré de retourner les fonctionnalités de téléphonie pour une ligne spécifiée. Cet OID demande également au gestionnaire d’appels ou au pilote MCM d’indiquer si les adresses sur cette ligne ont des fonctionnalités de téléphonie différentes.

Cette requête utilise une structure de CO_TAPI_LINE_CAPS, définie comme suit, pour interroger les fonctionnalités de téléphonie d’une ligne spécifiée :

typedef struct _CO_TAPI_LINE_CAPS {
    IN  ULONG           ulLineID;
    OUT ULONG           ulFlags;
    OUT LINE_DEV_CAPS   LineDevCaps;
} CO_TAPI_LINE_CAPS, *PCO_TAPI_LINE_CAPS;

Les membres de cette structure contiennent les informations suivantes :

ulLineID
Spécifie la ligne pour laquelle les fonctionnalités de téléphonie doivent être retournées. ulLineID est un identificateur de base zéro.

ulFlags
Si la ligne prend en charge plusieurs adresses qui ont des fonctionnalités de téléphonie différentes, le gestionnaire d’appels ou le pilote MCM définit le bit CO_TAPI_FLAG_PER_ADDRESS_CAPS dans ulFlags ; sinon, le gestionnaire d’appels ou le pilote MCM efface ce bit. Tous les bits non définis sont réservés et doivent être définis sur 0.

LineDevCaps
Spécifie les fonctionnalités de téléphonie d’une ligne, mise en forme comme structure LINE_DEV_CAPS. Pour plus d’informations sur cette structure, consultez le Microsoft Windows SDK et le fichier d’en-tête ndistapi.h.

Notes

Après avoir interrogé les fonctionnalités de téléphonie d’un appareil de gestionnaire d’appels ou d’un pilote MCM avec OID_CO_TAPI_CM_CAPS, un client orienté connexion interroge les fonctionnalités de téléphonie des lignes prises en charge par l’appareil.

• Si toutes les lignes prises en charge par l’appareil ont les mêmes fonctionnalités de ligne et que toutes les adresses de ces lignes ont les mêmes fonctionnalités d’adresse, le client OID_CO_TAPI_LINE_CAPS une fois pour obtenir les fonctionnalités de ligne de l’appareil. Dans ce cas, les fonctionnalités de ligne retournées par le gestionnaire d’appels ou le pilote MCM s’appliquent à toutes les lignes prises en charge par l’appareil.
• Toutefois, si l’appareil prend en charge plusieurs lignes avec des fonctionnalités différentes, et/ou si les adresses de ces lignes ont des fonctionnalités d’adresse différentes, le client interroge OID_CO_TAPI_LINE_CAPS une fois pour chaque ligne prise en charge par l’appareil afin d’obtenir les fonctionnalités de chaque ligne.

Le paramètre ulFlags détermine le nombre de fois que le client interroge par la suite les fonctionnalités de la ou des adresses sur la ligne :

• Si la ligne ne prend en charge qu’une seule adresse ou si la ligne prend en charge plusieurs adresses qui ont les mêmes fonctionnalités d’adresse, le client OID_CO_TAPI_ADDRESS_CAPS une seule fois.
• Si la ligne prend en charge plusieurs adresses qui ont des fonctionnalités différentes, le client doit interroger OID_CO_TAPI_ADDRESS_CAPS une fois pour chaque adresse sur la ligne.

Spécifications

Version : Windows Vista et versions ultérieures En-tête : Ntddndis.h (inclure Ndis.h)