TSPI_phoneNegotiateTSPIVersion-Funktion (tspi.h)
Die TSPI_phoneNegotiateTSPIVersion-Funktion gibt die höchste SPI-Version zurück, unter der der Dienstanbieter für dieses Gerät arbeiten kann, da der Bereich der möglichen SPI-Versionen vorhanden ist.
Syntax
LONG TSPIAPI TSPI_phoneNegotiateTSPIVersion(
DWORD dwDeviceID,
DWORD dwLowVersion,
DWORD dwHighVersion,
LPDWORD lpdwTSPIVersion
);
Parameter
dwDeviceID
Das Telefongerät, für das die Schnittstellenversionsverhandlung ausgeführt werden soll. Zulässige Werte liegen ausschließlich innerhalb des Bereichs der Bezeichner von Telefongeräten für diesen Dienstanbieter; der Wert INITIALIZE_NEGOTIATION nie an diese Funktion übergeben wird.
dwLowVersion
Die niedrigste TSPI-Versionsnummer, unter der TAPI betrieben werden kann. Die wichtigste WORD-Version ist die Hauptversionsnummer, und die am wenigsten signifikante WORD ist die Nebenversionsnummer.
dwHighVersion
Die höchste TSPI-Versionsnummer, unter der TAPI betrieben werden kann. Die wichtigste WORD-Version ist die Hauptversionsnummer, und die am wenigsten signifikante WORD ist die Nebenversionsnummer.
lpdwTSPIVersion
Ein Zeiger auf ein DWORD. Nach erfolgreicher Rückgabe dieser Funktion füllt der Dienstanbieter diesen Speicherort mit der höchsten TSPI-Versionsnummer innerhalb des vom Aufrufer angeforderten Bereichs aus, unter dem der Dienstanbieter arbeiten kann. Die wichtigste WORD-Version ist die Hauptversionsnummer, und das am wenigsten signifikante WORD ist die Nebenversionsnummer. Wenn der angeforderte Bereich den vom Dienstanbieter unterstützten Bereich nicht überschneidet, gibt die Funktion PHONEERR_INCOMPATIBLEAPIVERSION zurück.
Rückgabewert
Gibt null zurück, wenn die Funktion erfolgreich ist, oder eine Fehlernummer, wenn ein Fehler auftritt. Mögliche Rückgabewerte sind:
PHONEERR_INCOMPATIBLEAPIVERSION, PHONEERR_RESOURCEUNAVAIL, PHONEERR_NODRIVER, PHONEERR_OPERATIONFAILED, PHONEERR_NOMEM, PHONEERR_OPERATIONUNAVAIL.
Hinweise
Der Dienstanbieter gibt PHONEERR_OPERATIONUNAVAIL zurück, wenn der Vorgang nicht verfügbar ist. Wenn der Dienstanbieter jedoch Telefongeräte unterstützt, muss er auch diese Funktion unterstützen, und die Funktion darf keine PHONEERR_OPERATIONUNAVAIL zurückgeben.
TAPI ruft diese Funktion frühzeitig in der Initialisierungssequenz für jedes Telefongerät auf.
Die Aushandlung einer Erweiterungsversion erfolgt über das separate Verfahren TSPI_phoneNegotiateExtVersion.
Die entsprechende Funktion auf TAPI-Ebene ist eine überladene Funktion, die auch den Vom Dienstanbieter unterstützten Erweiterungsbezeichner abruft, sofern vorhanden. Auf TSPI-Ebene erfolgt das Abrufen des Erweiterungsbezeichners durch eine separate Prozedur, nämlich TSPI_phoneGetExtensionID.
Anforderungen
Zielplattform | Windows |
Kopfzeile | tspi.h |