función TSPI_phoneGetIcon (tspi.h)
La función TSPI_phoneGetIcon recupera un icono específico del dispositivo telefónico de servicio (o específico del proveedor) para mostrarlo al usuario.
Sintaxis
LONG TSPIAPI TSPI_phoneGetIcon(
DWORD dwDeviceID,
LPCWSTR lpszDeviceClass,
LPHICON lphIcon
);
Parámetros
dwDeviceID
Dispositivo telefónico cuyo icono se solicita.
lpszDeviceClass
Puntero a una cadena Unicode terminada en null que identifica un nombre de clase de dispositivo. Esta clase de dispositivo permite al autor de la llamada seleccionar un subicono específico aplicable a esa clase de dispositivo. Este parámetro es opcional y se puede dejar NULL o estar vacío, en cuyo caso se selecciona el icono de nivel más alto asociado al dispositivo telefónico en lugar de un dispositivo de flujo multimedia especificado.
lphIcon
Puntero a una ubicación de memoria en la que se devuelve el identificador al icono.
Valor devuelto
Devuelve cero si la función se ejecuta correctamente o un número de error si se produce un error. Los valores devueltos posibles son los siguientes:
PHONEERR_INVALDEVICECLASS, PHONEERR_OPERATIONFAILED, PHONEERR_NOMEM, PHONEERR_OPERATIONUNAVAIL, PHONEERR_RESOURCEUNAVAIL.
Comentarios
TSPI_phoneGetIcon hace que el proveedor devuelva un identificador (en el DWORD al que apunta lphIcon) a un recurso de icono (obtenido del
Función LoadIcon ) asociada al teléfono especificado. El identificador de icono es para un recurso asociado al proveedor.
El parámetro lpszDeviceClass permite al proveedor devolver iconos diferentes en función del tipo de servicio al que hace referencia el autor de la llamada. Las cadenas permitidas son las mismas que para TSPI_phoneGetID. Por ejemplo, si el teléfono admite comm API, pasar comm/datamodem como lpszDeviceClass hace que el proveedor devuelva un icono relacionado específicamente con las funciones de dispositivo Comm del proveedor de servicios. Para obtener más información sobre las clases de dispositivo comunes, consulte Clases de dispositivo TSPI.
Los parámetros "tapi/phone", "" o NULL se pueden usar para solicitar el icono del dispositivo telefónico. Un proveedor puede optar por admitir muchos iconos (seleccionados por lpszDeviceClass o número de teléfono), un único icono (por ejemplo, para el fabricante, que se devolvería para todas las solicitudes phoneGetIcon independientemente de la lpszDeviceClass seleccionada) o ningún icono, en cuyo caso establece el DWORD al que apunta lphIcon en NULL. TAPI examina el identificador devuelto por el proveedor y, si el proveedor devuelve NULL, TAPI sustituye un icono de telefonía genérico incluido como un recurso en TAPI (el icono de teléfono genérico).
Si el proveedor de servicios no admite iconos, puede dejar esta función sin implementar, en cuyo caso TAPI proporciona un icono de teléfono genérico para la aplicación.
Requisitos
| Plataforma de destino | Windows |
| Encabezado | tspi.h |