TSPI_providerEnumDevices función (tspi.h)

Artículo
03/03/2024

TAPI llama a la función TSPI_providerEnumDevices antes de TSPI_providerInit para determinar el número de dispositivos de línea y teléfono compatibles con el proveedor de servicios.

Sintaxis

LONG TSPIAPI TSPI_providerEnumDevices(
  DWORD      dwPermanentProviderID,
  LPDWORD    lpdwNumLines,
  LPDWORD    lpdwNumPhones,
  HPROVIDER  hProvider,
  LINEEVENT  lpfnLineCreateProc,
  PHONEEVENT lpfnPhoneCreateProc
);

Parámetros

dwPermanentProviderID

Identificador permanente, único dentro de los proveedores de servicios de este sistema, del proveedor de servicios que se inicializa.

lpdwNumLines

Puntero a una ubicación de memoria de tamaño DWORD en la que el proveedor de servicios debe escribir el número de dispositivos de línea que está configurado para admitir. TAPI inicializa el valor en 0, por lo que si el proveedor de servicios no puede escribir otro valor, se supone que el valor 0.

lpdwNumPhones

Puntero a una ubicación de memoria de tamaño DWORD en la que el proveedor de servicios debe escribir el número de dispositivos telefónicos que está configurado para admitir. TAPI inicializa el valor en 0, por lo que si el proveedor de servicios no puede escribir otro valor, se supone que el valor 0.

hProvider

Valor de tamaño DWORD opaco que identifica de forma única esta instancia de este proveedor de servicios durante esta ejecución del entorno de telefonía.

lpfnLineCreateProc

Puntero al procedimiento de devolución de llamada LINEEVENT proporcionado por TAPI. El proveedor de servicios usa esta función para enviar mensajes LINE_CREATE cuando es necesario crear un nuevo dispositivo de línea.

lpfnPhoneCreateProc

Puntero al procedimiento de devolución de llamada PHONEEVENT proporcionado por TAPI. El proveedor de servicios usa esta función para enviar mensajes PHONE_CREATE cuando es necesario crear un nuevo dispositivo telefónico.

Valor devuelto

Devuelve cero si la solicitud se realiza correctamente o si se produce un error. Los valores devueltos posibles son:

LINEERR_NOMEM, LINEERR_OPERATIONFAILED.

Comentarios

En versiones anteriores de TAPI, la implementación de esta función era opcional. A partir de TAPI 2.0, la implementación de esta función es obligatoria en todos los proveedores de servicios. TAPI ya no comprueba Telephon.ini ni el Registro en el inicio de TAPI para determinar el número inicial de líneas y teléfonos compatibles con un proveedor de servicios.

Un nuevo dispositivo puede aparecer antes de la finalización del procedimiento de TSPI_providerInit . TAPI controla correctamente los mensajes de _CREATE durante la inicialización del proveedor.