OID_CO_TAPI_TRANSLATE_TAPI_CALLPARAMS

Le OID_CO_TAPI_TRANSLATE_TAPI_CALLPARAMS OID demande un gestionnaire d’appels ou un pilote mcm (integrated call manager miniport) pour traduire les paramètres d’appel TAPI en paramètres d’appel NDIS. Le client qui interroge cet OID utilise les paramètres d’appel NDIS retournés en tant qu’entrée (mise en forme comme structure de CO_CALL_PARAMETERS ) dans NdisClMakeCall, avec laquelle le client place un appel sortant.

Cet OID utilise une structure CO_TAPI_TRANSLATE_TAPI_CALLPARAMS, qui est définie comme suit :

typedef struct _CO_TAPI_TRANSLATE_TAPI_CALLPARAMS {
    IN  ULONG               ulLineID;
    IN  ULONG               ulAddressID;
    IN  ULONG               ulFlags;
    IN  NDIS_VAR_DATA_DESC  DestAddress;
    IN  NDIS_VAR_DATA_DESC  LineCallParams;
    OUT NDIS_VAR_DATA_DESC  NdisCallParams;
} CO_TAPI_TRANSLATE_TAPI_CALLPARAMS, *PCO_TAPI_TRANSLATE_TAPI_CALLPARAMS;

Les membres de cette structure contiennent les informations suivantes :

ulLineID
Spécifie un identificateur de ligne de base zéro vers lequel l’appel sortant sera dirigé.

ulAddressID
Spécifie un identificateur d’adresse de base zéro (sur la ligne spécifiée par ulLineID) vers lequel l’appel sortant sera dirigé.

ulFlags
Le client doit définir le CO_TAPI_FLAG_OUTGOING_CALL bit dans ulFlags. Le client peut éventuellement définir le bit CO_TAPI_USE_DEFAULT_CALLPARAMS dans ulFlags pour exiger que le gestionnaire d’appels ou le pilote MCM ignore les LineCallParams et retourne les paramètres d’appel NDIS par défaut pour l’appareil.

DestAddress
Spécifie une structure NDIS_VAR_DATA_DESC qui contient un décalage entre le début de la structure NDIS_VAR_DATA_DESC et une adresse de destination mise en forme sous forme de tableau de caractères. La structure NDIS_VAR_DATA_DESC contient également la longueur de l’adresse de destination. L’adresse de destination est l’adresse vers laquelle l’appel sortant sera dirigé.

LineCallParams
Spécifie une structure NDIS_VAR_DATA_DESC qui contient un décalage entre le début de la structure NDIS_VAR_DATA_DESC et une structure LINE_CALL_PARAMS. La structure NDIS_VAR_DATA_DESC contient également la longueur de la structure LINE_CALL_PARAMS. La structure LINE_CALL_PARAMS spécifie les paramètres d’appel TAPI à traduire en paramètres d’appel NDIS. Pour plus d’informations sur la structure LINE_CALL_PARAMS, consultez le Microsoft Windows SDK et le fichier d’en-tête ndistapi.h.

NdisCallParams
Spécifie une structure NDIS_VAR_DATA_DESC qui contient un décalage entre le début de la structure NDIS_VAR_DATA_DESC et une structure CO_CALL_PARAMETERS. La structure NDIS_VAR_DATA_DESC contient également la longueur de la structure CO_CALL_PARAMETERS . La structure CO_CALL_PARAMETERS spécifie les paramètres d’appel NDIS dans lesquels les paramètres d’appel TAPI donnés ont été traduits.

Notes

Si la demande réussit, le gestionnaire d’appels ou le pilote MCM remplit la structure CO_CALL_PARAMETERS référencée par NdisCallParams avec les paramètres d’appel NDIS traduits. Le gestionnaire d’appels ou le pilote MCM doit allouer la structure CO_CALL_PARAMETERS dans la section de mémoire plate mentionnée par NdisCallParams. Le client écrit la longueur totale de la structure CO_CALL_PARAMETERS dans NdisCallParams.Length.

Si le client définit le bit CO_TAPI_USE_DEFAULT_CALLPARAMS dans ulFlags, le client ne spécifie pas les paramètres d’appel TAPI. Dans ce cas, le gestionnaire d’appels ou le pilote MCM doit retourner les paramètres d’appel NDIS par défaut pour l’appareil. S’il n’existe aucun paramètre d’appel NDIS par défaut pour l’appareil, le gestionnaire d’appels ou le pilote MCM doivent retourner NDIS_STATUS_FAILURE.

Spécifications

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