Compartilhar via


função TSPI_phoneGetLamp (tspi.h)

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

Sintaxe

LONG TSPIAPI TSPI_phoneGetLamp(
  HDRVPHONE hdPhone,
  DWORD     dwButtonLampID,
  LPDWORD   lpdwLampMode
);

Parâmetros

hdPhone

O identificador para o telefone cujo modo de lâmpada deve ser recuperado.

dwButtonLampID

O identificador da lâmpada a ser consultada.

lpdwLampMode

Um ponteiro para um local de memória no qual o provedor de serviços grava o modo de lâmpada status da lâmpada fornecida. Esse parâmetro pode ter no máximo uma das constantes PHONELAMPMODE_.

Retornar valor

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

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

Comentários

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

Requisitos

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

Confira também

PHONECAPS

Constantes PHONELAMPMODE_

TSPI_phoneGetDevCaps

TSPI_phoneSetLamp