Función phoneGetID (tapi.h)

La función phoneGetID devuelve un identificador de dispositivo para la clase de dispositivo especificada asociada al dispositivo telefónico especificado.

Sintaxis

LONG phoneGetID(
  HPHONE      hPhone,
  LPVARSTRING lpDeviceID,
  LPCSTR      lpszDeviceClass
);

Parámetros

hPhone

Controla un dispositivo telefónico abierto.

lpDeviceID

Puntero a una estructura de datos 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 clase de dispositivo (API) para asignar nombres a los dispositivos.

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:

PHONEERR_INVALPHONEHANDLE, PHONEERR_NOMEM, PHONEERR_INVALPOINTER, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALDEVICECLASS, PHONEERR_UNINITIALIZED, PHONEERR_OPERATIONFAILED, PHONEERR_STRUCTURETOOSMALL, PHONEERR_OPERATIONUNAVAIL.

Comentarios

La función phoneGetID se puede usar para recuperar un identificador de dispositivo telefónico dado un identificador de teléfono. También se puede usar para obtener el identificador de dispositivo del dispositivo multimedia (para clases de dispositivo como COM, wave, MIDI, teléfono, línea o NDIS) asociados con el dispositivo telefónico abierto. Los nombres de estas clases de dispositivo no distinguen mayúsculas de minúsculas. Después, este identificador se puede usar con la API multimedia adecuada para seleccionar el dispositivo correspondiente.

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

Un proveedor que define un tipo de medio específico del dispositivo también debe definir la API específica del dispositivo (propietaria) correspondiente para administrar los dispositivos del tipo de medio. 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 tanto al proveedor como, a continuación, el tipo de medio. Por ejemplo: "intel/video".

Requisitos

   
Plataforma de destino Windows
Encabezado tapi.h
Library Tapi32.lib
Archivo DLL Tapi32.dll

Consulte también

Funciones complementarias del servicio telefónico

Introducción a la referencia de TAPI 2.2

VARSTRING