PHONESTATUS 構造体 (tapi.h)

[アーティクル]
03/02/2024

PHONESTATUS 構造体は、電話デバイスの現在の状態を表します。 phoneGetStatus 関数と TSPI_phoneGetStatus 関数は、この構造体を返します。

構文

typedef struct phonestatus_tag {
  DWORD dwTotalSize;
  DWORD dwNeededSize;
  DWORD dwUsedSize;
  DWORD dwStatusFlags;
  DWORD dwNumOwners;
  DWORD dwNumMonitors;
  DWORD dwRingMode;
  DWORD dwRingVolume;
  DWORD dwHandsetHookSwitchMode;
  DWORD dwHandsetVolume;
  DWORD dwHandsetGain;
  DWORD dwSpeakerHookSwitchMode;
  DWORD dwSpeakerVolume;
  DWORD dwSpeakerGain;
  DWORD dwHeadsetHookSwitchMode;
  DWORD dwHeadsetVolume;
  DWORD dwHeadsetGain;
  DWORD dwDisplaySize;
  DWORD dwDisplayOffset;
  DWORD dwLampModesSize;
  DWORD dwLampModesOffset;
  DWORD dwOwnerNameSize;
  DWORD dwOwnerNameOffset;
  DWORD dwDevSpecificSize;
  DWORD dwDevSpecificOffset;
  DWORD dwPhoneFeatures;
} PHONESTATUS, *LPPHONESTATUS;

メンバー

dwTotalSize

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

dwNeededSize

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

dwUsedSize

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

dwStatusFlags

この電話デバイスの状態フラグ。このメンバーは、PHONESTATUSFLAGS_定数のいずれかを使用します。

dwNumOwners

電話の所有者特権を持つアプリケーションモジュールの数。

dwNumMonitors

電話のモニター特権を持つアプリケーションモジュールの数。

dwRingMode

電話デバイスの現在のリングモード。

dwRingVolume

電話デバイスの現在のリングボリューム。これは、0x00000000 (無音) と0x0000FFFF (最大ボリューム) の間の値です。

dwHandsetHookSwitchMode

携帯電話のハンドセットの現在のフックスイッチモード。このメンバーは、 PHONEHOOKSWITCHMODE_定数のいずれかを使用します。

dwHandsetVolume

携帯電話のハンドセットデバイスの現在のスピーカーボリューム。これは、0x00000000 (無音) と0x0000FFFF (最大ボリューム) の間の値です。

dwHandsetGain

携帯電話のハンドセットデバイスの現在のマイクゲイン。これは、0x00000000 (無音) と0x0000FFFF (最大ゲイン) の間の値です。

dwSpeakerHookSwitchMode

電話機のスピーカーフォンの現在のフックスイッチモード。このメンバーは、 PHONEHOOKSWITCHMODE_定数のいずれかを使用します。

dwSpeakerVolume

電話機のスピーカーデバイスの現在のスピーカーボリューム。これは、0x00000000 (無音) と0x0000FFFF (最大ボリューム) の間の値です。

dwSpeakerGain

電話機のスピーカーデバイスの現在のマイクゲイン。これは、0x00000000 (無音) と0x0000FFFF (最大ゲイン) の間の値です。

dwHeadsetHookSwitchMode

電話機のヘッドセットの現在のフックスイッチモード。このメンバーは、 PHONEHOOKSWITCHMODE_定数のいずれかを使用します。

dwHeadsetVolume

電話機のヘッドセットデバイスの現在のスピーカーボリューム。これは、0x00000000 (無音) と0x0000FFFF (最大ボリューム) の間の値です。

dwHeadsetGain

電話機のヘッドセットデバイスの現在のマイクゲイン。これは、0x00000000 (無音) と0x0000FFFF (最大ゲイン) の間の値です。

dwDisplaySize

表示情報のサイズ (バイト単位)。

dwDisplayOffset

この構造体の先頭から、携帯電話の現在の表示情報を含む可変サイズのフィールドへのオフセット。フィールドのサイズは dwDisplaySize によって指定されます。

dwLampModesSize

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

dwLampModesOffset

この構造の始まりから、携帯電話の現在のランプモードを含む可変サイズのフィールドへのオフセット。フィールドのサイズは dwLampModesSize によって指定されます。

dwOwnerNameSize

null ターミネータを含む現在の所有者の名前のサイズ (バイト単位)。

dwOwnerNameOffset

構造体の先頭から、電話デバイスの現在の所有者であるアプリケーションの名前を含む可変サイズのフィールドへのオフセット。名前は、 phoneInitialize または phoneInitializeEx で呼び出されたときにアプリケーションによって提供されるアプリケーション名です。アプリケーション名が指定されていない場合は、代わりにアプリケーションのファイル名が使用されます。フィールドのサイズは dwOwnerNameSize によって指定されます。電話に現在所有者がいない場合、 dwOwnerNameSize は 0 です。

dwDevSpecificSize

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

dwDevSpecificOffset

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

dwPhoneFeatures

デバイス機能の機能の可用性、現在のデバイスの状態、呼び出し元アプリケーションのデバイス所有権を考慮して、電話で呼び出すことができるテレフォニー API 関数を示すフラグ。 0 は、対応する機能を現在の状態の電話でアプリケーションが呼び出すことができない場合を示します。1 つは、機能を呼び出すことができる場合を示します。このメンバーは、1 つ以上の PHONEFEATURE_定数を使用します。