lineDevSpecificFeature-Funktion (tapi.h)
Die lineDevSpecificFeature-Funktion ermöglicht Dienstanbietern den Zugriff auf Features, die von anderen TAPI-Funktionen nicht angeboten werden. Die Bedeutung dieser Erweiterungen ist gerätespezifisch, und die Nutzung dieser Erweiterungen erfordert, dass die Anwendung sie vollständig kennt.
Syntax
LONG lineDevSpecificFeature(
HLINE hLine,
DWORD dwFeature,
LPVOID lpParams,
DWORD dwSize
);
Parameter
hLine
Handle zum Leitungsgerät.
dwFeature
Feature, das auf dem Leitungsgerät aufgerufen werden soll. Dieser Parameter verwendet die PHONEBUTTONFUNCTION_ Konstanten.
lpParams
Zeiger auf einen Speicherbereich, der zum Speichern eines featureabhängigen Parameterblocks verwendet wird. Das Format dieses Parameterblocks ist gerätespezifisch, und sein Inhalt wird von TAPI an oder vom Dienstanbieter übergeben.
dwSize
Größe des Puffers in Bytes.
Rückgabewert
Gibt einen positiven Anforderungsbezeichner zurück, wenn die Funktion asynchron abgeschlossen wird, oder eine negative Fehlernummer, wenn ein Fehler auftritt. Der dwParam2-Parameter der entsprechenden LINE_REPLY Meldung ist null, wenn die Funktion erfolgreich ist, oder es ist eine negative Fehlernummer, wenn ein Fehler auftritt. Mögliche Rückgabewerte sind:
LINEERR_INVALFEATURE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALLINEHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALPOINTER, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_UNINITIALIZED.
Zusätzliche Rückgabewerte sind gerätespezifisch.
Hinweise
Dieser Vorgang ist Teil der erweiterten Telefoniedienste. Sie bietet Zugriff auf ein gerätespezifisches Feature, ohne dessen Bedeutung zu definieren. Dieser Vorgang ist nur verfügbar, wenn die Anwendung erfolgreich eine gerätespezifische Erweiterungsversion ausgehandelt hat.
Diese Funktion stellt die Anwendung mit Funktionen zur Telefonfunktionsschaltfläche-Emulation bereit. Wenn eine Anwendung diesen Vorgang aufruft, gibt sie das Äquivalent eines Schaltflächen-Drücken-Ereignisses an. Diese Methode zum Aufrufen von Features ist geräteabhängig, da TAPI deren Bedeutung nicht definiert. In der Regel funktioniert eine Anwendung, die auf diesen gerätespezifischen Erweiterungen basiert, nicht mit anderen Dienstanbieterumgebungen.
Die Struktur, auf die von lpParams verwiesen wird, sollte keine Zeiger enthalten, da sie beim Ausführen einer 16-Bit-Anwendung in einer 32-Bit-Version von TAPI nicht ordnungsgemäß übersetzt (thunked) würden und umgekehrt.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | tapi.h |
| Bibliothek | Tapi32.lib |
| DLL | Tapi32.dll |