PHONESTATUS-Struktur (tapi.h)

Artikel
03/04/2024

Die PHONESTATUS-Struktur beschreibt die aktuelle status eines Telefongeräts. Die Funktionen phoneGetStatus und TSPI_phoneGetStatus geben diese Struktur zurück.

Syntax

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;

Member

dwTotalSize

Dieser Datenstruktur zugeordnete Gesamtgröße in Byte.

dwNeededSize

Größe für diese Datenstruktur, die benötigt wird, um alle zurückgegebenen Informationen in Bytes zu enthalten.

dwUsedSize

Größe des Teils dieser Datenstruktur, der nützliche Informationen in Byte enthält.

dwStatusFlags

Statusflags für dieses Telefongerät. Dieser Member verwendet eine der PHONESTATUSFLAGS_ Konstanten.

dwNumOwners

Anzahl der Anwendungsmodule mit Besitzerberechtigung für das Telefon.

dwNumMonitors

Anzahl der Anwendungsmodule mit Überwachungsberechtigung für das Telefon.

dwRingMode

Aktueller Klingelmodus eines Telefongeräts.

dwRingVolume

Aktuelle Klingellautstärke eines Telefongeräts. Dies ist ein Wert zwischen 0x00000000 (Stille) und 0x0000FFFF (maximale Lautstärke).

dwHandsetHookSwitchMode

Aktueller Hookswitch-Modus des Telefonhörers. Dieser Member verwendet eine der PHONEHOOKSWITCHMODE_ Konstanten.

dwHandsetVolume

Aktuelle Lautsprecherlautstärke des Telefongeräts. Dies ist ein Wert zwischen 0x00000000 (Stille) und 0x0000FFFF (maximale Lautstärke).

dwHandsetGain

Aktuelle Mikrofonverstärkung des Telefongeräts. Dies ist ein Wert zwischen 0x00000000 (Stille) und 0x0000FFFF (maximaler Gewinn).

dwSpeakerHookSwitchMode

Aktueller Hookswitch-Modus der Freisprecheinrichtung des Telefons. Dieser Member verwendet eine der PHONEHOOKSWITCHMODE_ Konstanten.

dwSpeakerVolume

Aktuelle Lautsprecherlautstärke des Lautsprechergeräts des Telefons. Dies ist ein Wert zwischen 0x00000000 (Stille) und 0x0000FFFF (maximale Lautstärke).

dwSpeakerGain

Aktuelle Mikrofonverstärkung des Lautsprechergeräts des Telefons. Dies ist ein Wert zwischen 0x00000000 (Stille) und 0x0000FFFF (maximaler Gewinn).

dwHeadsetHookSwitchMode

Aktueller Hookswitch-Modus des Headsets des Telefons. Dieser Member verwendet eine der PHONEHOOKSWITCHMODE_ Konstanten.

dwHeadsetVolume

Aktuelle Lautsprecherlautstärke des Headset-Geräts des Telefons. Dies ist ein Wert zwischen 0x00000000 (Stille) und 0x0000FFFF (maximale Lautstärke).

dwHeadsetGain

Aktuelle Mikrofonverstärkung des Headset-Geräts des Telefons. Dies ist ein Wert zwischen 0x00000000 (Stille) und 0x0000FFFF (maximaler Gewinn).

dwDisplaySize

Größe der Anzeigeinformationen in Bytes.

dwDisplayOffset

Offset vom Anfang dieser Struktur zu dem Feld mit unterschiedlicher Größe, das die aktuellen Anzeigeinformationen des Telefons enthält. Die Größe des Felds wird von dwDisplaySize angegeben.

dwLampModesSize

Größe des aktuellen Arrays der Lampenmodi in Byte.

dwLampModesOffset

Offset vom Anfang dieser Struktur zum variabel dimensionierten Feld, das die aktuellen Lampenmodi des Telefons enthält. Die Größe des Felds wird durch dwLampModesSize angegeben.

dwOwnerNameSize

Größe des Namens des aktuellen Besitzers, einschließlich des NULL-Abschlusszeichens , in Byte.

dwOwnerNameOffset

Offset vom Anfang der Struktur zu dem Feld mit variabeler Größe, das den Namen der Anwendung enthält, die der aktuelle Besitzer des Telefongeräts ist. Der Name ist der Anwendungsname, der von der Anwendung bereitgestellt wird, wenn sie mit phoneInitialize oder phoneInitializeEx aufgerufen wurde. Wenn kein Anwendungsname angegeben wurde, wird stattdessen der Dateiname der Anwendung verwendet. Die Größe des Felds wird durch dwOwnerNameSize angegeben. Wenn das Telefon derzeit keinen Besitzer hat, ist dwOwnerNameSize null.

dwDevSpecificSize

Größe des gerätespezifischen Felds in Bytes. Wenn die gerätespezifischen Informationen ein Zeiger auf eine Zeichenfolge sind, muss die Größe den NULL-Abschlusszeichen enthalten.

dwDevSpecificOffset

Offset vom Anfang dieser Struktur zum variabel dimensionierten gerätespezifischen Feld. Die Größe des Felds wird von dwDevSpecificSize angegeben.

dwPhoneFeatures

Flags, die angeben, welche Telefonie-API-Funktionen auf dem Telefon aufgerufen werden können, unter Berücksichtigung der Verfügbarkeit des Features in den Gerätefunktionen, des aktuellen Gerätestatus und des Gerätebesitzes der aufrufenden Anwendung. Eine Null gibt an, dass das entsprechende Feature von der Anwendung auf dem Telefon im aktuellen Zustand nicht aufgerufen werden kann. eine gibt an, dass das Feature aufgerufen werden kann. Dieser Member verwendet eine oder mehrere der PHONEFEATURE_ Konstanten.

Hinweise

Gerätespezifische Erweiterungen sollten den DevSpecific-Bereich (dwDevSpecificSize und dwDevSpecificOffset) mit unterschiedlicher Größe dieser Datenstruktur verwenden.

Das dwPhoneFeatures-Element ist nur für Anwendungen verfügbar, die das Telefongerät mit einer API-Version von 2.0 oder höher öffnen.