Función lineGetID (tapi.h)

Artículo
03/05/2024

La función lineGetID devuelve un identificador de dispositivo para la clase de dispositivo especificada asociada a la línea, dirección o llamada seleccionada.

Sintaxis

LONG lineGetID(
  HLINE       hLine,
  DWORD       dwAddressID,
  HCALL       hCall,
  DWORD       dwSelect,
  LPVARSTRING lpDeviceID,
  LPCSTR      lpszDeviceClass
);

Parámetros

hLine

Identificador de un dispositivo de línea abierta.

dwAddressID

Dirección en el dispositivo de línea abierta especificado. Un identificador de dirección está asociado permanentemente a una dirección; el identificador permanece constante en las actualizaciones del sistema operativo.

hCall

Identificador de una llamada.

dwSelect

Especifica si el identificador de dispositivo solicitado está asociado a la línea, la dirección o una sola llamada. Este parámetro usa una y solo una de las LINECALLSELECT_ Constantes.

lpDeviceID

Puntero a una ubicación de memoria de tipo VARSTRING, donde se devuelve el identificador del dispositivo. Una vez completada correctamente la solicitud, esta ubicación se rellena con el identificador del dispositivo. El formato de la información devuelta depende del método utilizado por la API de clase de dispositivo para asignar nombres a los dispositivos. Antes de llamar a lineGetID, la aplicación debe establecer el miembro dwTotalSize de esta estructura para indicar la cantidad de memoria disponible para TAPI para devolver información.

Nota Si los parámetros de tamaño de la estructura no son correctos, existe la posibilidad de que se sobrescriban los datos. Para obtener más información sobre cómo establecer tamaños de estructura, consulte el tema de asignación de memoria .

lpszDeviceClass

Puntero a una cadena terminada en null que especifica la clase de dispositivo del dispositivo cuyo identificador se solicita. Las cadenas de clase de dispositivo válidas son las que se usan en la sección SYSTEM.INI para identificar las clases de dispositivo.

Valor devuelto

Devuelve cero si la solicitud se realiza correctamente o un número de error negativo si se produce un error. Los valores devueltos posibles son:

LINEERR_INVALLINEHANDLE, LINEERR_NOMEM, LINEERR_INVALADDRESSID, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALCALLSELECT, LINEERR_INVALDEVICECLASS, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_STRUCTURETOOSMALL, LINEERR_NODEVICE, LINEERR_UNINITIALIZED.

Comentarios

La función lineGetID se puede usar para recuperar un identificador de dispositivo de línea cuando se le asigna un identificador de línea. Esto resulta útil después de que lineOpen se haya abierto con LINEMAPPER como identificador de dispositivo para determinar el identificador real del dispositivo de línea de la línea abierta. Esta función también se puede usar para obtener el identificador de dispositivo de un dispositivo telefónico o un dispositivo multimedia (para clases de dispositivo como COM, wave, MIDI, teléfono, línea o NDIS) asociados a una llamada, dirección o línea. A continuación, este identificador se puede usar con la API adecuada (por ejemplo, teléfono, MIDI, onda) para seleccionar el dispositivo multimedia correspondiente asociado a la llamada especificada.

Consulte Clases de dispositivo TAPI para los nombres de clase de dispositivo.

Un proveedor que define un modo multimedia específico del dispositivo también debe definir la API específica del dispositivo (propietaria) correspondiente para administrar los dispositivos del modo multimedia. Para evitar colisiones en los nombres de clase de dispositivo asignados de forma independiente por distintos proveedores, un proveedor debe seleccionar un nombre que identifique de forma única al proveedor y, después, el tipo de medio. Por ejemplo: "intel/video".