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

Vedi anche

INITIALIZE_NEGOTIATION

TSPI_phoneGetExtensionID

TSPI_phoneNegotiateExtVersion