Função phoneDevSpecific (tapi.h)

Artigo
03/02/2024

A função phoneDevSpecific é usada como um mecanismo de extensão geral para habilitar uma implementação de API de Telefonia para fornecer recursos não descritos nas outras funções TAPI. Os significados dessas extensões são específicos do dispositivo.

Sintaxe

LONG phoneDevSpecific(
  HPHONE hPhone,
  LPVOID lpParams,
  DWORD  dwSize
);

Parâmetros

hPhone

Identificador para um dispositivo de telefone.

lpParams

Ponteiro para uma área de memória usada para manter um bloco de parâmetros. Sua interpretação é específica do dispositivo. O conteúdo do bloco de parâmetros é passado inalterado de ou para o provedor de serviços pelo TAPI.

dwSize

Tamanho da área do bloco de parâmetros, em bytes.

Retornar valor

Retornará um identificador de solicitação positivo se a função for concluída de forma assíncrona ou um número de erro negativo se ocorrer um erro. O parâmetro dwParam2 da mensagem de PHONE_REPLY correspondente será zero se a função for bem-sucedida ou se for um número de erro negativo se ocorrer um erro. Os valores retornados possíveis são:

PHONEERR_INVALPHONEHANDLE, PHONEERR_NOMEM, PHONEERR_INVALPOINTER, PHONEERR_RESOURCEUNAVAIL, PHONEERR_OPERATIONUNAVAIL, PHONEERR_UNINITIALIZED, PHONEERR_OPERATIONFAILED.

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

Comentários

Essa operação fornece um perfil de parâmetro genérico. A interpretação do bloco de parâmetros é específica do dispositivo. Indicações e respostas específicas do dispositivo devem usar a mensagem PHONE_DEVSPECIFIC .

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 (específica do fornecedor) que descreve quais extensões são definidas. Normalmente, um aplicativo que depende dessas extensões específicas do dispositivo não é portátil para trabalhar com outros ambientes de provedor de serviços.