función TSPI_providerCreatePhoneDevice (tspi.h)
TAPI llama a la función TSPI_providerCreatePhoneDevice en respuesta a la recepción de un mensaje de PHONE_CREATE del proveedor de servicios, lo que permite la creación dinámica de un nuevo dispositivo telefónico.
Sintaxis
LONG TSPIAPI TSPI_providerCreatePhoneDevice(
DWORD_PTR dwTempID,
DWORD dwDeviceID
);
Parámetros
dwTempID
Identificador de dispositivo temporal que el proveedor de servicios pasó a TAPI en el mensaje de PHONE_CREATE .
dwDeviceID
Identificador de dispositivo que TAPI asigna a este dispositivo si esta función se realiza correctamente.
Valor devuelto
Devuelve cero si la solicitud se realiza correctamente o un número de error si se produce un error. Los valores devueltos posibles de PHONEERR_ Constantes son:
PHONEERR_BADDEVICEID, PHONEERR_NOMEM, PHONEERR_OPERATIONFAILED.
Comentarios
Cuando TAPI recibe un mensaje de PHONE_CREATE de un proveedor de servicios, llama a esta función (nunca llama a esta función espontáneamente). TAPI agrega 1 al número de dispositivos de ese tipo y pasa el identificador de dispositivo nuevo y sin usar resultante como parámetro dwDeviceID a esta función. También pasa en la función el parámetro dwParam2 del mensaje PHONE_CREATE como dwTempID. Es probable que al agregar el nuevo dispositivo al final de la lista de dispositivos se produzcan identificadores de dispositivo no contiguos para el proveedor de servicios; Los proveedores de servicios que admiten la creación dinámica de dispositivos también deben admitir identificadores de dispositivo no contiguos.
Si el proveedor de servicios reconoce el parámetro dwTempID y se configura correctamente las estructuras y, de este modo, necesita admitir el nuevo dispositivo, guarda el dwDeviceID y devuelve SUCCESS. Si esta función no es correcta, TAPI no agrega el dispositivo y no hay ningún efecto negativo (se omite el mensaje de PHONE_CREATE ). Si esta función se completa correctamente, TAPI informa a las aplicaciones de la disponibilidad del nuevo dispositivo mediante mensajes PHONE_CREATE o PHONE_STATE (PHONESTATE_REINIT).
Sin embargo, los proveedores de servicios más antiguos que no exportan esta función tampoco deben enviar mensajes PHONE_CREATE, lo que significa que TAPI no intentaría llamar a esta función.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Windows |
| Encabezado | tspi.h |