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

Weitere Informationen

INITIALIZE_NEGOTIATION

TSPI_phoneGetExtensionID

TSPI_phoneNegotiateExtVersion