TSPI_phoneOpen-Funktion (tspi.h)
Die TSPI_phoneOpen-Funktion öffnet das Telefongerät, dessen Geräte-ID angegeben ist, gibt das undurchsichtige Handle des Dienstanbieters für das Gerät zurück und behält den undurchsichtigen Handle des TAPI für das Gerät zur Verwendung in nachfolgenden Aufrufen der PHONEEVENT-Prozedur bei.
Syntax
LONG TSPIAPI TSPI_phoneOpen(
DWORD dwDeviceID,
HTAPIPHONE htPhone,
LPHDRVPHONE lphdPhone,
DWORD dwTSPIVersion,
PHONEEVENT lpfnEventProc
);
Parameter
dwDeviceID
Das zu öffnende Telefongerät.
htPhone
Das undurchsichtige TAPI-Handle für das Telefongerät, das in nachfolgenden Aufrufen des PHONEEVENT-Rückrufverfahrens verwendet werden soll, um das Gerät zu identifizieren.
lphdPhone
Ein Zeiger auf ein HDRVPHONE , bei dem der Dienstanbieter seinen Handle für das Telefongerät schreibt, das von TAPI in nachfolgenden Anrufen verwendet werden soll, um das Gerät zu identifizieren.
dwTSPIVersion
Die über TSPI_phoneNegotiateTSPIVersion ausgehandelte TSPI-Version, unter der der Dienstanbieter arbeiten kann.
lpfnEventProc
Ein Zeiger auf die PHONEEVENT-Rückrufprozedur , die von TAPI bereitgestellt wird, die der Dienstanbieter aufruft, um nachfolgende Ereignisse auf dem Telefon 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:
PHONEERR_ALLOCATED, PHONEERR_NOMEM, PHONEERR_INCOMPATIBLEAPIVERSION, PHONEERR_RESOURCEUNAVAIL, PHONEERR_NODRIVER, PHONEERR_OPERATIONFAILED, PHONEERR_INUSE, PHONEERR_OPERATIONUNAVAIL, PHONEERR_INIFILECORRUPT.
Hinweise
Das Öffnen eines Telefons berechtigt TAPI, weitere Anfragen am Telefon zu stellen. Das Telefon wird in dem Sinne aktiv, dass der Dienstanbieter asynchrone Ereignisse wie Hookswitch-Änderungen oder Tastendruck melden kann. Der Dienstanbieter behält sich alle nicht zu verwertbaren Ressourcen vor, die für die Verwaltung des Telefons erforderlich sind. Beispielsweise sollte das Öffnen eines Telefons, auf das über einen Comm-Port und ein Modem zugegriffen wird, dazu führen, dass der Comm-Port geöffnet wird, sodass es nicht mehr für die Verwendung durch andere Anwendungen verfügbar ist.
Wenn die Funktion erfolgreich ist, werden sowohl TAPI als auch der Dienstanbieter verpflichtet, unter der angegebenen Schnittstellenversionsnummer für dieses geöffnete Gerät zu arbeiten. Nachfolgende Vorgänge und Ereignisse, die mithilfe der ausgetauschten undurchsichtigen Telefonhandles identifiziert wurden, entsprechen dieser Schnittstellenversion. Diese Verpflichtung und die Gültigkeit der Handles bleiben wirksam, bis TAPI das Telefon mit TSPI_phoneClose schließt oder bis der Dienstanbieter das PHONE_CLOSE-Ereignis meldet. Wenn die Funktion nicht erfolgreich ist, wird keine solche Verpflichtung getroffen, und die Handles sind ungültig.
Anforderungen
| Zielplattform | Windows |
| Kopfzeile | tspi.h |