função TSPI_lineDevSpecificFeature (tspi.h)

A função TSPI_lineDevSpecificFeature é usada como um mecanismo de extensão para permitir que os provedores de serviços forneçam acesso a recursos não descritos em outras operações. Os significados dessas extensões são específicos do dispositivo e aproveitar essas extensões exige que o TAPI ou seu aplicativo cliente estejam totalmente cientes delas.

Sintaxe

LONG TSPIAPI TSPI_lineDevSpecificFeature(
  DRV_REQUESTID dwRequestID,
  HDRVLINE      hdLine,
  DWORD         dwFeature,
  LPVOID        lpParams,
  DWORD         dwSize
);

Parâmetros

dwRequestID

O identificador da solicitação assíncrona.

hdLine

O identificador do provedor de serviços para o dispositivo de linha.

dwFeature

O recurso a ser invocado no dispositivo de linha. Esse parâmetro usa constantes PHONEBUTTONFUNCTION_.

lpParams

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

dwSize

O tamanho do buffer em bytes. 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 possíveis valores retornados são os seguintes:

LINEERR_INVALFEATURE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALLINEHANDLE, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL.

Comentários

Valores retornados adicionais são específicos do dispositivo. O estado de chamada do hdCall é específico do dispositivo.

Essa função fornece aos aplicativos TAPI recursos de emulação de botão de recurso do telefone. Quando o TAPI invoca essa operação em nome de um aplicativo cliente, ele especifica o equivalente a um evento "botão pressionar". Esse método de invocação de recursos é altamente dependente do dispositivo, pois a API não define seu significado. Quando um aplicativo depende de extensões específicas do dispositivo, o aplicativo não se porta bem para outros ambientes do provedor de serviços.

Essa função é chamada em resposta direta a um aplicativo que chama a função TAPI lineDevSpecificFeature . O TAPI converte o parâmetro hLine usado no nível TAPI para o parâmetro hdLine correspondente usado no nível de TSPI. O buffer lpParams é passado por meio de não modificado.

Nota A estrutura de dados lpParams não deve conter ponteiros porque eles não são traduzidos corretamente (thunked) ao executar um aplicativo de 16 bits em uma versão de 32 bits do TAPI e vice-versa.

 

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 a TAPI tiver negociado e selecionado com êxito 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_DEVSPECIFICFEATURE

Constantes PHONEBUTTONFUNCTION_