PHONESTATUS-Struktur (tapi.h)
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.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header | tapi.h |