função TSPI_lineCreateMSPInstance (tspi.h)

Artigo
08/26/2023

A função TSPI_lineCreateMSPInstance direciona a DLL do TAPI 3 para criar uma instância do MSP (provedor de serviços de mídia) para um dispositivo de linha específico. Essa função retorna um identificador TSP para a chamada MSP. Essa função requer a negociação de versão do TAPI 3.0.

Sintaxe

LONG TSPIAPI TSPI_lineCreateMSPInstance(
  HDRVLINE      hdLine,
  DWORD         dwAddressID,
  HTAPIMSPLINE  htMSPLine,
  LPHDRVMSPLINE lphdMSPLine
);

Parâmetros

hdLine

O identificador do provedor de serviços para a linha.

dwAddressID

Um endereço no dispositivo de linha aberta especificado. Um identificador de endereço está permanentemente associado a um endereço; o identificador permanece constante entre as atualizações do sistema operacional.

htMSPLine

O identificador TAPI para a chamada MSP.

lphdMSPLine

Ponteiro para o identificador TSP para a chamada MSP.

Valor retornado

LINEERR_INVALLINEHANDLE, LINEERR_INVALPOINTER, NOERROR

Comentários

O provedor de serviços deve salvar o campo de identificador htMSPLine , a ser usado ao enviar mensagens LINE_SENDMSPDATA para TAPISRV.

Uma instância MSP está associada a um aplicativo específico. Se vários aplicativos estiverem em execução, cada linha TSP poderá ter várias instâncias MSP.