TSPI_phoneGetID función (tspi.h)
La función TSPI_phoneGetID devuelve un identificador de dispositivo para la clase de dispositivo especificada asociada al dispositivo telefónico especificado.
Sintaxis
LONG TSPIAPI TSPI_phoneGetID(
HDRVPHONE hdPhone,
LPVARSTRING lpDeviceID,
LPCWSTR lpszDeviceClass,
HANDLE hTargetProcess
);
Parámetros
hdPhone
Identificador del teléfono que se va a consultar.
lpDeviceID
Puntero a una estructura de datos de tipo VARSTRING donde se devuelve 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. Antes de llamar a TSPI_phoneGetID, la aplicación establece el miembro dwTotalSize de esta estructura para indicar la cantidad de memoria disponible para TAPI para devolver información.
lpszDeviceClass
Puntero a una cadena Unicode terminada en null que especifica la clase de dispositivo del dispositivo cuyo identificador se solicita.
hTargetProcess
Identificador de proceso de la aplicación en nombre de la que se invoca la función TSPI_phoneGetID . Si la información que se devuelve en la estructura VARSTRING incluye un identificador para su uso por parte de la aplicación, el proveedor de servicios crea o duplica el identificador del proceso.
Valor devuelto
Devuelve cero si la función se realiza correctamente o un número de error si se produce un error. Los valores devueltos posibles son los siguientes:
PHONEERR_INVALPHONEHANDLE, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALDEVICECLASS, PHONEERR_OPERATIONFAILED, PHONEERR_NOMEM, PHONEERR_OPERATIONUNAVAIL.
Comentarios
Esta operación 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 y mciwave) asociados con el dispositivo telefónico abierto. Después, este identificador se puede usar con la API multimedia adecuada (como mci, midi y wav) para seleccionar el dispositivo correspondiente. Para obtener más información sobre los nombres de clase de dispositivo comunes, consulte Clases de dispositivo TSPI.
El proveedor de servicios rellena todos los miembros de la estructura de datos VARSTRING , excepto dwTotalSize, que está rellenado por TAPI. El proveedor de servicios no debe sobrescribir el miembro dwTotalSize .
El proveedor de servicios no necesita preocuparse por controlar las clases de dispositivo tapi/line y tapi/phone, ya que TAPI los controla para el proveedor de servicios. Por lo tanto, el código para controlar estas clases de dispositivo es opcional.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Windows |
| Encabezado | tspi.h |