次の方法で共有


PHONESTATUS 構造体 (tapi.h)

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_定数を使用します

注釈

デバイス固有の拡張機能では、このデータ構造の DevSpecific (dwDevSpecificSizedwDevSpecificOffset) の可変サイズ領域を使用する必要があります。

dwPhoneFeatures メンバーは、API バージョン 2.0 以降で電話デバイスを開くアプリケーションでのみ使用できます。

要件

要件
Header tapi.h

こちらもご覧ください

TSPI_phoneGetStatus

phoneGetStatus

phoneInitialize

phoneInitializeEx