Freigeben über


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

Weitere Informationen

Referenz zu erweiterten Telefoniediensten

LINE_REPLY

ÜBERSICHT ÜBER TAPI 2.2-Referenz