Compartilhar via


função TSPI_phoneSetHookSwitch (tspi.h)

A função TSPI_phoneSetHookSwitch define o estado do gancho dos dispositivos hookswitch do telefone aberto especificado para o modo especificado. Somente o estado hookswitch dos dispositivos hookswitch listados é afetado.

Sintaxe

LONG TSPIAPI TSPI_phoneSetHookSwitch(
  DRV_REQUESTID dwRequestID,
  HDRVPHONE     hdPhone,
  DWORD         dwHookSwitchDevs,
  DWORD         dwHookSwitchMode
);

Parâmetros

dwRequestID

O identificador da solicitação assíncrona.

hdPhone

O identificador para o telefone que contém os dispositivos hookswitch cujos modos devem ser definidos.

dwHookSwitchDevs

Os dispositivos cujo modo hookswitch deve ser definido. Esse parâmetro usa uma das constantes PHONEHOOKSWITCHDEV_.

dwHookSwitchMode

O modo hookswitch a ser definido. Esse parâmetro pode ter apenas uma das constantes PHONEHOOKSWITCHMODE_.

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 se for um número de erro se ocorrer um erro. Os valores retornados possíveis são os seguintes:

PHONEERR_INVALPHONEHANDLE, PHONEERR_NOMEM, PHONEERR_INVALHOOKSWITCHDEV, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALHOOKSWITCHMODE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALPHONESTATE PHONEERR_OPERATIONUNAVAIL.

Comentários

O modo hookswitch é alterado para a configuração indicada para todos os dispositivos especificados. Se forem desejadas configurações diferentes, essa função poderá ser invocada várias vezes com um conjunto diferente de parâmetros. Uma mensagem PHONE_STATE é enviada ao aplicativo depois que o estado hookswitch é alterado.

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho tspi.h

Confira também

Constantes PHONEHOOKSWITCHDEV_

Constantes PHONEHOOKSWITCHMODE_

PHONESTATUS

PHONE_STATE

TSPI_phoneGetHookSwitch