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
| Requisito | Value |
|---|---|
| Plataforma de destino | Windows |
| Encabezado | tapi.h |
| Library | Tapi32.lib |
| Archivo DLL | Tapi32.dll |
Consulte también
Funciones complementarias del servicio telefónico