TSPI_phoneSetStatusMessages-Funktion (tspi.h)
Die TSPI_phoneSetStatusMessages-Funktion bewirkt, dass der Dienstanbieter status Nachrichten filtert, die derzeit für keine Anwendung von Interesse sind.
Syntax
LONG TSPIAPI TSPI_phoneSetStatusMessages(
HDRVPHONE hdPhone,
DWORD dwPhoneStates,
DWORD dwButtonModes,
DWORD dwButtonStates
);
Parameter
hdPhone
Das undurchsichtige Handle für das Telefon, dessen Statusänderungsüberwachungsfilter festgelegt werden soll.
dwPhoneStates
Flags, die den Satz der Telefon-status Änderungen und Ereignisse angeben, für die TAPI Benachrichtigungsnachrichten empfangen möchte. Dieser Parameter kann null, 1 oder mehr als eine der PHONESTATE_ Konstanten aufweisen.
dwButtonModes
Flags, die den Satz von Telefonschaltflächenmodi angeben, für die TAPI Benachrichtigungsnachrichten empfangen möchte. Wenn dwButtonModes null ist, wird dwButtonStates ignoriert. Dieser Parameter kann null, 1 oder mehr als eine der PHONEBUTTONMODE_ Konstanten aufweisen. Wenn für dwButtonModes mindestens eines dieser Flags festgelegt ist, muss für dwButtonStates auch mindestens ein Bit festgelegt sein:
dwButtonStates
Dieser Parameter gibt den Satz von Telefonschaltflächenstatusänderungen an, für die TAPI Benachrichtigungsnachrichten empfangen möchte, eine der PHONEBUTTONSTATE_ Konstanten.
Rückgabewert
Gibt null zurück, wenn die Funktion erfolgreich ist, oder eine Fehlernummer, wenn ein Fehler auftritt. Mögliche Rückgabewerte sind wie folgt:
PHONEERR_INVALPHONEHANDLE, PHONEERR_NOMEM, PHONEERR_INVALPHONESTATE, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALBUTTONMODE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALBUTTONSTATE, PHONEERR_OPERATIONUNAVAIL.
Hinweise
TAPI definiert eine Reihe von Nachrichten, die Anwendungen über Ereignisse auf Smartphones benachrichtigen. Die Sätze aller Änderungsmeldungen, an denen alle Anwendungen interessiert sind, können viel kleiner sein als der Satz möglicher Nachrichten. Mit diesem Verfahren kann TAPI dem Dienstanbieter den reduzierten Satz von Nachrichten mitteilen, die übermittelt werden sollen. Der Dienstanbieter übermittelt alle unterstützten Nachrichten innerhalb der angegebenen Gruppe. Es ist zulässig, mehr zu liefern (sie werden von TAPI herausgefiltert), es wird jedoch aus Leistungsgründen davon abgeraten. Wenn TAPI die Übermittlung eines bestimmten Nachrichtentyps anfordert, der nicht vom Anbieter erstellt wird, akzeptiert der Anbieter die Anforderung trotzdem, erzeugt die Nachricht aber einfach nicht. Alle telefon status Nachrichten mit Ausnahme von PHONESTATE_REINIT sind standardmäßig deaktiviert.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | tspi.h |