PHONECAPS 構造体 (tapi.h)

[アーティクル]
03/08/2023

PHONECAPS 構造では、電話デバイスの機能について説明します。 phoneGetDevCaps 関数と TSPI_phoneGetDevCaps 関数は、この構造体を返します。

構文

typedef struct phonecaps_tag {
  DWORD dwTotalSize;
  DWORD dwNeededSize;
  DWORD dwUsedSize;
  DWORD dwProviderInfoSize;
  DWORD dwProviderInfoOffset;
  DWORD dwPhoneInfoSize;
  DWORD dwPhoneInfoOffset;
  DWORD dwPermanentPhoneID;
  DWORD dwPhoneNameSize;
  DWORD dwPhoneNameOffset;
  DWORD dwStringFormat;
  DWORD dwPhoneStates;
  DWORD dwHookSwitchDevs;
  DWORD dwHandsetHookSwitchModes;
  DWORD dwSpeakerHookSwitchModes;
  DWORD dwHeadsetHookSwitchModes;
  DWORD dwVolumeFlags;
  DWORD dwGainFlags;
  DWORD dwDisplayNumRows;
  DWORD dwDisplayNumColumns;
  DWORD dwNumRingModes;
  DWORD dwNumButtonLamps;
  DWORD dwButtonModesSize;
  DWORD dwButtonModesOffset;
  DWORD dwButtonFunctionsSize;
  DWORD dwButtonFunctionsOffset;
  DWORD dwLampModesSize;
  DWORD dwLampModesOffset;
  DWORD dwNumSetData;
  DWORD dwSetDataSize;
  DWORD dwSetDataOffset;
  DWORD dwNumGetData;
  DWORD dwGetDataSize;
  DWORD dwGetDataOffset;
  DWORD dwDevSpecificSize;
  DWORD dwDevSpecificOffset;
  DWORD dwDeviceClassesSize;
  DWORD dwDeviceClassesOffset;
  DWORD dwPhoneFeatures;
  DWORD dwSettableHandsetHookSwitchModes;
  DWORD dwSettableSpeakerHookSwitchModes;
  DWORD dwSettableHeadsetHookSwitchModes;
  DWORD dwMonitoredHandsetHookSwitchModes;
  DWORD dwMonitoredSpeakerHookSwitchModes;
  DWORD dwMonitoredHeadsetHookSwitchModes;
  GUID  PermanentPhoneGuid;
} PHONECAPS, *LPPHONECAPS;

メンバー

dwTotalSize

このデータ構造に割り当てられた合計サイズ (バイト単位)。

dwNeededSize

返されるすべての情報をバイト単位で保持するために必要な、このデータ構造のサイズ。

dwUsedSize

有用な情報を含むこのデータ構造の部分のサイズ (バイト単位)。

dwProviderInfoSize

プロバイダー固有の情報のサイズ (バイト単位)。プロバイダー固有の情報が文字列へのポインターである場合、サイズには null ターミネータを含める必要があります。

dwProviderInfoOffset

構造体の先頭から、サービスプロバイダー固有の情報を含む可変サイズのフィールドへのオフセット。

このメンバーは、プロバイダーのハードウェアやソフトウェアに関する情報 (ハードウェアとソフトウェアのベンダー名やバージョン番号など) を提供します。この情報は、ユーザーがプロバイダーに関する問題のあるカスタマーサービスを呼び出す必要がある場合に役立ちます。フィールドのサイズは dwProviderInfoSize によって指定されます。

dwPhoneInfoSize

電話固有の情報のサイズ (バイト単位)。電話固有の情報が文字列へのポインターである場合、サイズには null ターミネータを含める必要があります。

dwPhoneInfoOffset

構造体の先頭から、電話固有の情報を含む可変サイズのデバイスフィールドへのオフセット。

このメンバーは、電話デバイスの製造元、モデル名、ソフトウェアバージョンなど、接続されている電話デバイスに関する情報を提供します。この情報は、ユーザーが電話に関する問題のあるカスタマーサービスを呼び出す必要がある場合に役立ちます。フィールドのサイズは dwPhoneInfoSize によって指定されます。

dwPermanentPhoneID

システムの構成で電話デバイスが認識される永続的な識別子。

dwPhoneNameSize

null ターミネータを含む電話の構成可能な名前のサイズ (バイト単位)。

dwPhoneNameOffset

構造体の先頭から、この電話デバイスのユーザー構成可能な名前を含む可変サイズのデバイスフィールドへのオフセット。この名前は、電話デバイスのサービスプロバイダーを構成するときにユーザーが構成でき、ユーザーの便宜のために提供されます。フィールドのサイズは dwPhoneNameSize によって指定されます。

dwStringFormat

この電話デバイスで使用する文字列形式。このメンバーは、STRINGFORMAT_定数のいずれかを使用します。

dwPhoneStates

PHONE_STATE メッセージでアプリケーションに通知できるこの電話デバイスの状態の変更。このメンバーは、 PHONESTATE_定数の 1 つ以上です。

dwHookSwitchDevs

電話のフックスイッチデバイス。このメンバーは、PHONEHOOKSWITCHDEV_定数のいずれかを使用します。

dwHandsetHookSwitchModes

ハンドセットのフックスイッチモード。メンバーは、フックスイッチデバイスが dwHookSwitchDevs に一覧表示されている場合にのみ意味があります。 PHONEHOOKSWITCHMODE_定数のいずれかを使用します。

dwSpeakerHookSwitchModes

スピーカーのフックスイッチモード。メンバーは、フックスイッチデバイスが dwHookSwitchDevs に一覧表示されている場合にのみ意味があります。 PHONEHOOKSWITCHMODE_定数のいずれかを使用します。

dwHeadsetHookSwitchModes

ヘッドセットのフックスイッチモード。メンバーは、フックスイッチデバイスが dwHookSwitchDevs に一覧表示されている場合にのみ意味があります。 PHONEHOOKSWITCHMODE_定数のいずれかを使用します。

dwVolumeFlags

電話デバイスのスピーカーコンポーネントの音量設定機能。 PHONEHOOKSWITCHDEV_位置のビットが TRUE の場合、対応するフックスイッチデバイスのスピーカーコンポーネントの音量を phoneSetVolume で調整できます。

dwGainFlags

電話デバイスのマイクコンポーネントのゲイン設定機能。ビット位置PHONEHOOKSWITCHDEV_が TRUE の場合、対応するフックスイッチデバイスのマイクコンポーネントの音量を phoneSetGain で調整できます。

dwDisplayNumRows

電話ディスプレイの行数を記述して、電話デバイスの機能を表示します。 dwDisplayNumRows メンバーと dwDisplayNumColumns メンバーは、ディスプレイのない電話デバイスの場合、どちらも 0 です。

dwDisplayNumColumns

電話ディスプレイの列数を記述して、電話デバイスの機能を表示します。 dwDisplayNumRows メンバーと dwDisplayNumColumns メンバーは、ディスプレイのない電話デバイスの場合、どちらも 0 です。

dwNumRingModes

電話デバイスのリング機能。電話機は、 dwNumRingModes から 1 を引いた値を使用して、1、2 として識別される dwNumRingModes のさまざまなリングパターンで呼び出し可能です。このメンバーの値が 0 の場合、アプリケーションは電話のリングモードを制御できなくなります。このメンバーの値が 0 より大きい場合は、サービスプロバイダーによってサポートされている無音に加えて、リングモードの数を示します。 phoneGetRing の lpdwRingMode パラメーターまたは phoneSetRing の dwRingMode パラメーターの値が 0 の場合は、無音状態 (電話が呼び出されていないか、実行しないでください) を示し、dwRingMode 値 1 から dwNumRingModes は電話デバイスの有効なリングモードです。

dwNumButtonLamps

TAPI で検出可能な電話デバイス上のボタン/ランプの数。ボタン/ランプは、その識別子によって識別されます。有効なボタン/ランプ識別子の範囲は、0 から dwNumButtonLamps から 1 を引いた値です。キーパッドボタン '0' から '9'、'*'、および '#' には、識別子 0 から 12 が割り当てられます。

dwButtonModesSize

ボタンモード配列のサイズ (バイト単位)。

dwButtonModesOffset

この構造の先頭から、電話のボタンのボタンモードを含む可変サイズのフィールドへのオフセット。配列のインデックスは、ボタン/ランプ識別子によって示されます。この配列では、 PHONEBUTTONMODE_定数を使用します。配列のサイズは dwButtonModesSize によって指定されます。

dwButtonFunctionsSize

ボタン関数フィールドのサイズ (バイト単位)。

dwButtonFunctionsOffset

この構造の先頭から、電話機のボタンのボタン機能を含む可変サイズのフィールドへのオフセット。配列のインデックスは、ボタン/ランプ識別子によって示されます。この配列では、 PHONEBUTTONFUNCTION_定数を使用します。配列のサイズは dwButtonFunctionsSize によって指定されます。

dwLampModesSize

ランプモード配列のサイズ (バイト単位)。

dwLampModesOffset

この構造の始まりから、電話機のランプのランプモードを含む可変サイズのフィールドへのオフセット。配列のインデックスは、ボタン/ランプ識別子によって示されます。この配列では、 PHONELAMPMODE_定数を使用します。配列のサイズは dwLampModesSize によって指定されます。

dwNumSetData

電話デバイス内の異なるダウンロード領域の数。さまざまな領域は、データ ID 0、1、 dwNumSetData から 1 を引いた値を使用して参照されます。このメンバーが 0 の場合、電話はダウンロード機能をサポートしません。

dwSetDataSize

データサイズ配列のサイズ (バイト単位)。

dwSetDataOffset

この構造体の先頭から、電話のダウンロードデータ領域のサイズ (バイト単位) を含む可変サイズのフィールドへのオフセット。これは、 DWORD サイズの要素がデータ識別子によってインデックス付けされた配列です。配列のサイズは dwSetDataSize によって指定されます。

dwNumGetData

電話デバイス内の異なるアップロード領域の数。さまざまな領域は、データ ID 0、1、 dwNumGetData から 1 を引いた値を使用して参照されます。このフィールドが 0 の場合、電話はアップロード機能をサポートしません。

dwGetDataSize

データサイズ配列のサイズ (バイト単位)。

dwGetDataOffset

この構造体の先頭から、電話のアップロードデータ領域のサイズ (バイト単位) を含む可変サイズのフィールドへのオフセット。これは、 DWORD サイズの要素がデータ識別子によってインデックス付けされた配列です。配列のサイズは dwGetDataSize によって指定されます。

dwDevSpecificSize

デバイス固有フィールドのサイズ (バイト単位)。デバイス固有の情報が文字列へのポインターである場合、サイズには null ターミネータを含める必要があります。

dwDevSpecificOffset

この構造体の先頭から可変サイズのデバイス固有フィールドへのオフセット。フィールドのサイズは dwDevSpecificSize によって指定されます。

dwDeviceClassesSize

サポートされているデバイスクラス識別子のサイズ (バイト単位)。

dwDeviceClassesOffset

この構造体の先頭から、phoneGetID で使用するためにこのデバイスでサポートされているデバイスクラス識別子で構成される文字列へのオフセット。識別子は NULLs で区切られ、リストの最後の識別子の後に 2 つの NULLが続きます。フィールドのサイズは dwDeviceClassesSize によって指定されます。

dwPhoneFeatures

電話で呼び出すことができるテレフォニー API 関数を示すフラグ。 0 は、対応する機能が実装されていないことを示し、電話でアプリケーションが呼び出すことはできません。1 つは、デバイスの状態やその他の要因に応じて機能が呼び出される可能性があることを示します。このメンバーは、PHONEFEATURE_定数を使用します。

dwSettableHandsetHookSwitchModes

phoneSetHookSwitch を使用してハンドセットで設定できる値をPHONEHOOKSWITCHMODE_します。

dwSettableSpeakerHookSwitchModes

phoneSetHookSwitch を使用してスピーカーフォンで設定できる値をPHONEHOOKSWITCHMODE_します。

dwSettableHeadsetHookSwitchModes

phoneSetHookSwitch を使用してヘッドセットで設定できる値をPHONEHOOKSWITCHMODE_します。

dwMonitoredHandsetHookSwitchModes

PHONEHOOKSWITCHMODE_ PHONE_STATE メッセージと phoneGetHookSwitch によってハンドセットに対して検出および報告できる値です。

dwMonitoredSpeakerHookSwitchModes

PHONEHOOKSWITCHMODE_PHONE_STATE メッセージと phoneSetHookSwitch によって、スピーカーフォンに対して検出および報告できる値です。

dwMonitoredHeadsetHookSwitchModes

PHONEHOOKSWITCHMODE_ PHONE_STATE メッセージおよび phoneSetHookSwitch によってヘッドセットに対して検出および報告できる値です。