phoneGetLamp 関数 (tapi.h)

phoneGetLamp 関数は、指定したランプの現在のランプ モードを返します。

構文

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

パラメーター

hPhone

開いている電話デバイスにハンドルします。

dwButtonLampID

照会するランプの識別子。

lpdwLampMode

指定されたランプのランプ モードの状態を保持するメモリ位置へのポインター。 このパラメーターは、 PHONELAMPMODE_定数の 1 つだけを使用します。

戻り値

要求が成功した場合は 0 を返し、エラーが発生した場合は負のエラー番号を返します。 可能な戻り値は次のとおりです。

PHONEERR_INVALPHONEHANDLE、PHONEERR_NOMEM、PHONEERR_INVALBUTTONLAMPID、PHONEERR_RESOURCEUNAVAIL、PHONEERR_INVALPOINTER、PHONEERR_OPERATIONFAILED、PHONEERR_INVALPHONESTATE、PHONEERR_UNINITIALIZED、PHONEERR_OPERATIONUNAVAIL。

注釈

ボタンごとに複数のランプがある電話セットは、複数のボタン/ランプペアを使用してモデル化する必要があります。 各余分なボタン/ランプペアは、DUMMYボタンを使用する必要があります。

要件

こちらもご覧ください

補助電話サービス機能

TAPI 2.2 リファレンスの概要