fonction TSPI_phoneSetStatusMessages (tspi.h)
La fonction TSPI_phoneSetStatusMessages permet au fournisseur de services de filtrer status messages qui n’intéressent actuellement aucune application.
Syntaxe
LONG TSPIAPI TSPI_phoneSetStatusMessages(
HDRVPHONE hdPhone,
DWORD dwPhoneStates,
DWORD dwButtonModes,
DWORD dwButtonStates
);
Paramètres
hdPhone
Poignée opaque du téléphone dont le filtre de surveillance des changements d’état doit être défini.
dwPhoneStates
Indicateurs qui spécifient l’ensemble des modifications et événements de status téléphoniques pour lesquels TAPI souhaite recevoir des messages de notification. Ce paramètre peut avoir zéro, une ou plusieurs constantes PHONESTATE_.
dwButtonModes
Indicateurs qui spécifient l’ensemble des modes de bouton de téléphone pour lesquels TAPI souhaite recevoir des messages de notification. Si dwButtonModes est égal à zéro, dwButtonStates est ignoré. Ce paramètre peut avoir zéro, une ou plusieurs constantes PHONEBUTTONMODE_. Si dwButtonModes a au moins un de ces indicateurs définis, dwButtonStates doit également avoir au moins un bit défini :
dwButtonStates
Ce paramètre spécifie l’ensemble des modifications d’état du bouton du téléphone pour lesquelles TAPI souhaite recevoir des messages de notification, l’une des constantes PHONEBUTTONSTATE_.
Valeur retournée
Retourne zéro si la fonction réussit, ou un numéro d’erreur si une erreur se produit. Les valeurs de retour possibles sont les suivantes :
PHONEERR_INVALPHONEHANDLE, PHONEERR_NOMEM, PHONEERR_INVALPHONESTATE, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALBUTTONMODE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALBUTTONSTATE, PHONEERR_OPERATIONUNAVAIL.
Remarques
TAPI définit un certain nombre de messages qui informent les applications des événements qui se produisent sur les téléphones. Les ensembles de tous les messages de modification dans lesquels toutes les applications sont intéressées peuvent être beaucoup plus petits que l’ensemble de messages possibles. Cette procédure permet à TAPI d’indiquer au fournisseur de services l’ensemble réduit de messages à remettre. Le fournisseur de services remet tous les messages qu’il prend en charge, dans l’ensemble spécifié. Il est autorisé à fournir davantage (ils sont filtrés par TAPI), mais il est déconseillé de le faire pour des raisons de performances. Si TAPI demande la remise d’un type de message particulier qui n’est pas produit par le fournisseur, le fournisseur accepte néanmoins la demande, mais ne produit tout simplement pas le message. Tous les messages status téléphone, à l’exception des PHONESTATE_REINIT, sont désactivés par défaut.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | tspi.h |