OID_CO_TAPI_LINE_CAPS

El OID_CO_TAPI_LINE_CAPS OID solicita un administrador de llamadas o un controlador integrado del administrador de llamadas de miniporte (MCM) para devolver las funcionalidades de telefonía de una línea especificada. Este OID también solicita al administrador de llamadas o al controlador MCM que indique si las direcciones de esta línea tienen capacidades de telefonía diferentes.

Esta solicitud usa una estructura de CO_TAPI_LINE_CAPS, definida de la siguiente manera, para consultar las funcionalidades de telefonía de una línea especificada:

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;

Los miembros de esta estructura contienen la siguiente información:

ulLineID
Especifica la línea para la que se deben devolver las funcionalidades de telefonía. ulLineID es un identificador de base cero.

ulFlags
Si la línea admite varias direcciones que tienen capacidades de telefonía diferentes, el administrador de llamadas o el controlador MCM establece el bit de CO_TAPI_FLAG_PER_ADDRESS_CAPS en ulFlags; de lo contrario, el administrador de llamadas o el controlador MCM borra este bit. Todos los bits no definidos están reservados y deben establecerse en 0.

LineDevCaps
Especifica las funcionalidades de telefonía de una línea, con formato de estructura LINE_DEV_CAPS. Para obtener más información sobre esta estructura, vea el Microsoft Windows SDK y el archivo de encabezado ndistapi.h.

Observaciones

Después de consultar las funcionalidades de telefonía de un dispositivo del controlador MCM o del administrador de llamadas con OID_CO_TAPI_CM_CAPS, un cliente orientado a la conexión consulta las funcionalidades de telefonía de las líneas compatibles con el dispositivo.

• Si todas las líneas compatibles con el dispositivo tienen las mismas funcionalidades de línea y todas las direcciones de estas líneas tienen las mismas funcionalidades de dirección, el cliente consulta OID_CO_TAPI_LINE_CAPS una vez para obtener las funcionalidades de línea del dispositivo. En este caso, las funcionalidades de línea devueltas por el administrador de llamadas o el controlador MCM se aplican a todas las líneas compatibles con el dispositivo.
• Sin embargo, si el dispositivo admite varias líneas con funcionalidades diferentes y/o si las direcciones de estas líneas tienen funcionalidades de dirección diferentes, el cliente consulta OID_CO_TAPI_LINE_CAPS una vez por cada línea compatible con el dispositivo para obtener las funcionalidades de cada línea.

La configuración ulFlags determina cuántas veces el cliente consulta posteriormente las funcionalidades de las direcciones en la línea:

• Si la línea solo admite una dirección o si la línea admite varias direcciones que tienen las mismas funcionalidades de dirección, el cliente consulta OID_CO_TAPI_ADDRESS_CAPS una vez.
• Si la línea admite varias direcciones que tienen funcionalidades diferentes, el cliente debe consultar OID_CO_TAPI_ADDRESS_CAPS una vez para cada dirección de la línea.

Requisitos

Versión: Windows Vista y encabezado posterior: Ntddndis.h (incluya Ndis.h)