Compartilhar via


Método ITAddress2::D eviceSpecific (tapi3if.h)

O método DeviceSpecific permite que os provedores de serviços forneçam acesso aos recursos não oferecidos por outras funções TAPI. O significado das extensões é específico do dispositivo e aproveitar essas extensões exige que o aplicativo esteja totalmente ciente delas.

Esse método é fornecido para aplicativos C e C++. Aplicativos cliente de automação, como aqueles escritos no Visual Basic, devem usar o método DeviceSpecificVariant .

Sintaxe

HRESULT DeviceSpecific(
  [in] ITCallInfo *pCall,
  [in] BYTE       *pParams,
  [in] DWORD      dwSize
);

Parâmetros

[in] pCall

Ponteiro para a interface ITCallInfo do objeto de chamada.

[in] pParams

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; O TAPI passa seu conteúdo entre o aplicativo e o provedor de serviços.

[in] dwSize

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

Valor de retorno

Esse método pode retornar um desses valores.

Valor Significado
S_OK
Método bem-sucedido.
E_POINTER
O parâmetro pParams ou pCall não é um ponteiro válido.
E_OUTOFMEMORY
Existe memória insuficiente para executar a operação.

Observações

Cuidado

O TAPI gravará os dados retornados no buffer referenciado por pParams quando a mensagem LINE_REPLY for retornada. Isso significa que o buffer deve permanecer válido até que a mensagem LINE_REPLY seja retornada; caso contrário, podem ocorrer dados corrompidos e exceções.

Requisitos

Requisito Valor
da Plataforma de Destino Windows
cabeçalho tapi3if.h (inclua Tapi3.h)
Biblioteca Uuid.lib
de DLL Tapi3.dll

Consulte também

DeviceSpecificVariant

ITCallInfo

NegotiateExtVersion

lineDevSpecific