funzione TSPI_phoneNegotiateTSPIVersion (tspi.h)
La funzione TSPI_phoneNegotiateTSPIVersion restituisce la versione SPI più elevata in cui il provider di servizi può operare per questo dispositivo, in base all'intervallo di versioni spi possibili.
Sintassi
LONG TSPIAPI TSPI_phoneNegotiateTSPIVersion(
DWORD dwDeviceID,
DWORD dwLowVersion,
DWORD dwHighVersion,
LPDWORD lpdwTSPIVersion
);
Parametri
dwDeviceID
Dispositivo telefonico per il quale deve essere eseguita la negoziazione della versione dell'interfaccia. I valori consentiti sono rigorosamente compresi nell'intervallo di identificatori dei dispositivi telefonici per questo provider di servizi; il valore INITIALIZE_NEGOTIATION non viene mai passato a questa funzione.
dwLowVersion
Numero di versione TSPI più basso in base al quale può funzionare TAPI. Word più significativo è il numero di versione principale e il meno significativo word è il numero di versione secondario.
dwHighVersion
Numero di versione TSPI più alto in base al quale è possibile operare TAPI. Word più significativo è il numero di versione principale e il meno significativo word è il numero di versione secondario.
lpdwTSPIVersion
Puntatore a un DWORD. Al termine della restituzione da questa funzione, il provider di servizi riempie questa posizione con il numero di versione TSPI più alto, compreso nell'intervallo richiesto dal chiamante, in base al quale il provider di servizi può operare. Word più significativo è il numero di versione principale e word meno significativo è il numero di versione secondaria. Se l'intervallo richiesto non si sovrappone all'intervallo supportato dal provider di servizi, la funzione restituisce PHONEERR_INCOMPATIBLEAPIVERSION.
Valore restituito
Restituisce zero se la funzione ha esito positivo o un numero di errore se si verifica un errore. I valori restituiti possibili sono i seguenti:
PHONEERR_INCOMPATIBLEAPIVERSION, PHONEERR_RESOURCEUNAVAIL, PHONEERR_NODRIVER, PHONEERR_OPERATIONFAILED, PHONEERR_NOMEM, PHONEERR_OPERATIONUNAVAIL.
Commenti
Il provider di servizi restituisce PHONEERR_OPERATIONUNAVAIL se l'operazione non è disponibile. Tuttavia, se il provider di servizi supporta qualsiasi dispositivo telefonico, deve supportare anche questa funzione e la funzione non deve restituire PHONEERR_OPERATIONUNAVAIL.
TAPI chiama questa funzione all'inizio della sequenza di inizializzazione per ogni dispositivo telefonico.
La negoziazione di una versione dell'estensione viene eseguita tramite la procedura separata TSPI_phoneNegotiateExtVersion.
La funzione corrispondente a livello TAPI è una funzione di overload che recupera anche l'identificatore di estensione, se presente, supportato dal provider di servizi. A livello TSPI, il recupero dell'identificatore di estensione viene eseguito tramite una procedura separata, ovvero TSPI_phoneGetExtensionID.
Requisiti
| Piattaforma di destinazione | Windows |
| Intestazione | tspi.h |