TSPI_providerCreateLineDevice función (tspi.h)

TAPI llama a la función TSPI_providerCreateLineDevice en respuesta a la recepción de un mensaje de LINE_CREATE del proveedor de servicios, lo que permite la creación dinámica de un nuevo dispositivo de línea.

Sintaxis

LONG TSPIAPI TSPI_providerCreateLineDevice(
  DWORD_PTR dwTempID,
  DWORD     dwDeviceID
);

Parámetros

dwTempID

Identificador de dispositivo temporal que el proveedor de servicios pasó a TAPI en el mensaje LINE_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 son:

LINEERR_BADDEVICEID, LINEERR_NOMEM, LINEERR_OPERATIONFAILED.

Comentarios

Cuando TAPI recibe un mensaje de LINE_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 LINE_CREATE como dwTempID.

Nota 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 dwTempID y se configura correctamente las estructuras y de modo que necesite admitir el nuevo dispositivo, guarda el dwDeviceID y devuelve SUCCESS. Si esta función no se realiza correctamente, TAPI no agrega el dispositivo y no hay ningún efecto negativo (se omite el mensaje LINE_CREATE ). Si esta función se completa correctamente, TAPI informa a las aplicaciones de la disponibilidad del nuevo dispositivo mediante mensajes LINE_CREATE o LINE_LINEDEVSTATE (LINEDEVSTATE_REINIT).

Sin embargo, los proveedores de servicios más antiguos que no exportan esta función tampoco deben enviar mensajes LINE_CREATE, lo que significa que TAPI no intentaría llamar a esta función.

Requisitos

Plataforma de destino	Windows
Encabezado	tspi.h

Consulte también

LINE_CREATE

LINE_LINEDEVSTATE