Compartilhar via

função TSPI_lineDevSpecific (tspi.h)

  • Artigo

A função TSPI_lineDevSpecific é usada como um mecanismo de extensão geral para permitir que os provedores de serviços forneçam acesso a recursos não descritos em outras operações. Os significados das extensões são específicos do dispositivo e, para aproveitar essas extensões, o aplicativo deve estar totalmente ciente delas.

Sintaxe

LONG TSPIAPI TSPI_lineDevSpecific(
  DRV_REQUESTID dwRequestID,
  HDRVLINE      hdLine,
  DWORD         dwAddressID,
  HDRVCALL      hdCall,
  LPVOID        lpParams,
  DWORD         dwSize
);

Parâmetros

dwRequestID

O identificador da solicitação assíncrona.

hdLine

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

dwAddressID

O endereço na linha especificada na qual operar. Um identificador de endereço está permanentemente associado a um endereço; o identificador permanece constante entre as atualizações do sistema operacional.

hdCall

O identificador do provedor de serviços para a chamada a ser operada. Esse campo pode ter o valor NULL. O estado de chamada de hdCall é específico do dispositivo.

lpParams

Um ponteiro para uma área de memória usada para manter um bloco de parâmetros. O formato desse bloco de parâmetro é específico do dispositivo.

dwSize

O tamanho em bytes da área do bloco de parâmetros. Se o parâmetro lpParams for um ponteiro para uma cadeia de caracteres, o tamanho deverá incluir o terminador nulo .

Retornar valor

Retorna dwRequestID ou um número de erro se ocorrer um erro. O parâmetro real lResult do ASYNC_COMPLETION correspondente será zero se a função for bem-sucedida ou um número de erro se ocorrer um erro. Os valores retornados possíveis são os seguintes:

LINEERR_INVALLINEHANDLE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALADDRESSID, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL.

Comentários

Valores retornados adicionais são específicos do dispositivo.

Essa operação fornece um perfil de parâmetro genérico. A interpretação da estrutura de parâmetros é específica do dispositivo. TAPI sempre especifica o parâmetro hdLine . Se dwAddressID e/ou hdCall devem ser válidos é específico do dispositivo. Se especificado, eles devem pertencer a hdLine. As indicações e respostas enviadas de volta ao aplicativo que são específicas do dispositivo usam a mensagem LINE_DEVSPECIFIC .

Essa função é chamada em resposta direta a um aplicativo que chama a função TAPI lineDevSpecific. O TAPI converte os parâmetros hLine e hdCall usados no nível tapi para os parâmetros hdLine e hdCall correspondentes usados no nível do TSPI. O buffer lpParams é passado sem modificação.

Nota A estrutura de dados lpParams não deve conter ponteiros porque eles não seriam convertidos corretamente (conversão) ao executar um aplicativo de 16 bits em uma versão de 32 bits do TAPI e vice-versa.
 
Um provedor de serviços pode fornecer acesso a funções específicas do dispositivo definindo parâmetros para uso com essa operação. Os aplicativos que desejam usar essas extensões específicas do dispositivo devem consultar a documentação específica do dispositivo (neste caso, que significa específico do fornecedor) que descreve quais extensões são definidas.
Nota Um aplicativo que depende de extensões específicas do dispositivo não é portátil no trabalho com outros ambientes do provedor de serviços. Use extensões específicas do fornecedor.
 
Essa operação faz parte dos serviços de Telefonia Estendida. Ele só fornece acesso a um recurso específico do dispositivo sem definir seu significado. Essa operação só estará disponível se o aplicativo tiver negociado com êxito e selecionado uma versão de extensão específica do dispositivo.

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho tspi.h

Confira também

ASYNC_COMPLETION

LINE_DEVSPECIFIC

TSPI_lineNegotiateExtVersion