função TSPI_phoneDevSpecific (tspi.h)
A função TSPI_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 operações. Os significados dessas extensões são específicos do dispositivo.
Sintaxe
LONG TSPIAPI TSPI_phoneDevSpecific(
DRV_REQUESTID dwRequestID,
HDRVPHONE hdPhone,
LPVOID lpParams,
DWORD dwSize
);
Parâmetros
dwRequestID
O identificador da solicitação assíncrona.
hdPhone
O identificador para o telefone no qual uma operação específica do dispositivo deve ser executada.
lpParams
Um ponteiro para uma área de memória usada para manter um bloco de parâmetros. Sua interpretação é específica do dispositivo. O parâmetro lpParams não deve conter ponteiros. Para obter informações de volta ao aplicativo de TSPI_phoneDevSpecific, o provedor de serviços envia uma mensagem PHONE_DEVSPECIFIC com as informações.
dwSize
O tamanho em bytes da área do bloco de parâmetros.
Valor retornado
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 se for um número de erro se ocorrer um erro. Os possíveis valores retornados são os seguintes:
PHONEERR_INVALPHONEHANDLE, PHONEERR_OPERATIONUNAVAIL, PHONEERR_INVALPOINTER, PHONEERR_NOMEM, PHONEERR_OPERATIONFAILED, PHONEERR_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 do bloco de parâmetros é específica do dispositivo. Indicações e respostas específicas do dispositivo devem usar a mensagem PHONE_DEVSPECIFIC .
Essa função é chamada em resposta direta a um aplicativo que chamou a função TAPI phoneDevSpecific . O TAPI converte o parâmetro hPhone usado no nível TAPI para o parâmetro hdPhone correspondente usado no nível de TSPI. O buffer lpParams é passado por meio de não modificado.
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.
Requisitos
| Plataforma de Destino | Windows |
| Cabeçalho | tspi.h |