Compartilhar via


Função phoneGetLamp (tapi.h)

A função phoneGetLamp retorna o modo de lâmpada atual da lâmpada especificada.

Sintaxe

LONG phoneGetLamp(
  HPHONE  hPhone,
  DWORD   dwButtonLampID,
  LPDWORD lpdwLampMode
);

Parâmetros

hPhone

Manipule para o dispositivo de telefone aberto.

dwButtonLampID

Identificador da lâmpada a ser consultada.

lpdwLampMode

Ponteiro para um local de memória que contém o modo de lâmpada status da lâmpada fornecida. Esse parâmetro usa uma e apenas uma das constantes PHONELAMPMODE_.

Retornar valor

Retornará zero se a solicitação for bem-sucedida ou um número de erro negativo se ocorrer um erro. Os possíveis valores retornados são:

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

Comentários

Conjuntos de telefone que têm várias lâmpadas por botão devem ser modelados usando vários pares de botão/lâmpada. Cada par de botões/lâmpadas extras deve usar um botão DUMMY.

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho tapi.h
Biblioteca Tapi32.lib
DLL Tapi32.dll

Confira também

Funções de serviço de telefonia suplementar

Visão geral da referência do TAPI 2.2