TSPI_lineDevSpecificFeature-Funktion (tspi.h)
Die TSPI_lineDevSpecificFeature-Funktion wird als Erweiterungsmechanismus verwendet, um Dienstanbietern den Zugriff auf Features zu ermöglichen, die in anderen Vorgängen nicht beschrieben sind. Die Bedeutungen dieser Erweiterungen sind gerätespezifisch, und die Nutzung dieser Erweiterungen erfordert TAPI oder seine Clientanwendung, um sie vollständig zu kennen.
Syntax
LONG TSPIAPI TSPI_lineDevSpecificFeature(
DRV_REQUESTID dwRequestID,
HDRVLINE hdLine,
DWORD dwFeature,
LPVOID lpParams,
DWORD dwSize
);
Parameter
dwRequestID
Der Bezeichner der asynchronen Anforderung.
hdLine
Das Handle des Dienstanbieters für das Leitungsgerät.
dwFeature
Das Feature, das auf dem Zeilengerät aufgerufen werden soll. Dieser Parameter verwendet PHONEBUTTONFUNCTION_ Konstanten.
lpParams
Ein Zeiger auf einen Speicherbereich, der zum Speichern eines featureabhängigen Parameterblocks verwendet wird. Das Format dieses Parameterblocks ist gerätespezifisch.
dwSize
Die Größe des Puffers in Byte. Wenn der lpParams-Parameter ein Zeiger auf eine Zeichenfolge ist, muss die Größe den NULL-Abschlussator enthalten.
Rückgabewert
Gibt dwRequestID oder eine Fehlernummer zurück, wenn ein Fehler auftritt. Der tatsächliche lResult-Parameter der entsprechenden ASYNC_COMPLETION ist 0, wenn die Funktion erfolgreich ist, oder eine Fehlernummer, wenn ein Fehler auftritt. Mögliche Rückgabewerte sind wie folgt:
LINEERR_INVALFEATURE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALLINEHANDLE, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL.
Hinweise
Zusätzliche Rückgabewerte sind gerätespezifisch. Der Anrufstatus von hdCall ist gerätespezifisch.
Diese Funktion stellt TAPI-Anwendungen mit Funktionen zur Emulation von Schaltflächen für Telefonfeatures bereit. Wenn TAPI diesen Vorgang im Namen einer Clientanwendung aufruft, gibt er das Äquivalent zu einem "Button Press"-Ereignis an. Diese Methode zum Aufrufen von Features ist stark geräteabhängig, da die API ihre Bedeutung nicht definiert. Wenn eine Anwendung auf gerätespezifische Erweiterungen angewiesen ist, portiert die Anwendung nicht gut auf andere Dienstanbieterumgebungen.
Diese Funktion wird als direkte Antwort auf eine Anwendung aufgerufen, die die TAPI lineDevSpecificFeature-Funktion aufruft. TAPI übersetzt den auf TAPI-Ebene verwendeten hLine-Parameter in den entsprechenden hdLine-Parameter , der auf DER TSPI-Ebene verwendet wird. Der lpParams-Puffer wird unverändert übergeben.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | tspi.h |