TSPI_lineOpen-Funktion (tspi.h)

Artikel
03/13/2024

Die TSPI_lineOpen-Funktion öffnet das Leitungsgerät, dessen Geräte-ID angegeben ist, und gibt das Handle des Dienstanbieters für das Gerät zurück. Der Dienstanbieter muss das TAPI-Handle für das Gerät für die Verwendung in nachfolgenden Aufrufen der LINEEVENT-Rückrufprozedur beibehalten.

Syntax

LONG TSPIAPI TSPI_lineOpen(
  DWORD      dwDeviceID,
  HTAPILINE  htLine,
  LPHDRVLINE lphdLine,
  DWORD      dwTSPIVersion,
  LINEEVENT  lpfnEventProc
);

Parameter

dwDeviceID

Gibt das zu öffnende Leitungsgerät an.

htLine

Das TAPI-Handle für das Leitungsgerät, das bei nachfolgenden Aufrufen der LINEEVENT-Rückrufprozedur verwendet werden soll, um das Gerät zu identifizieren.

lphdLine

Ein Zeiger auf eine HDRVLINE , bei der der Dienstanbieter seinen Handle für das Leitungsgerät ausfüllt.

dwTSPIVersion

Die TSPI-Version.

lpfnEventProc

Ein Zeiger auf die von TAPI bereitgestellte LINEEVENT-Rückrufprozedur , die der Dienstanbieter aufruft, um nachfolgende Ereignisse in der Zeile zu melden.

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:

LINEERR_ALLOCATED, LINEERR_OPERATIONUNAVAIL, LINEERR_NODRIVER, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL.

Hinweise

Der Dienstanbieter sollte alle Nicht-Sharable-Ressourcen reservieren, die zum Verwalten der Leitung erforderlich sind. Alle Aktionen, die auf lineMakeCall verschoben werden können, sollten jedoch sein. Es ist eine Entwurfsannahme in TAPI, dass lineOpen ein "kostengünstiger" Vorgang ist. Wenn die Leitung beispielsweise nur im Überwachungsmodus geöffnet wird, sollte es nicht erforderlich sein, dass ein COMM-portbasierter Dienstanbieter den COMM-Port öffnet.

Dieses Verfahren entspricht keiner Prozedur auf TAPI-Ebene, bei der die Funktionen zum Aktivieren gerätespezifischer Erweiterungen, Auswählen von Linienmerkmalen und Festlegen der Medientyperkennung in die von lineOpen definierte Funktionalität einbezogen werden. Auf TSPI-Ebene werden diese zusätzlichen Funktionen in TSPI_lineNegotiateExtVersion, TSPI_lineSetDefaultMediaDetection und TSPI_lineConditionalMediaDetection unterteilt.