Compartilhar via

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

O método DeviceSpecific permite que os provedores de serviços forneçam acesso a recursos específicos do dispositivo 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] BYTE  *pParams,
  [in] DWORD dwSize
);

Parâmetros

[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

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

Valor de retorno

Esse método pode retornar um desses valores.

Código de retorno Descrição
S_OK
 Método bem-sucedido.
E_OUTOFMEMORY
 Existe memória insuficiente para executar a operação.
E_POINTER
 O parâmetro pParams não é um ponteiro válido.

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

NegotiateExtVersion

lineDevSpecific

  • Last updated on