funzione lineSetCallQualityOfService (tapi.h)

La funzione lineSetCallQualityOfService consente all'applicazione di tentare di modificare la qualità dei parametri del servizio (garanzie di capacità e prestazioni riservate) per una chiamata esistente. Ad eccezione della convalida dei parametri di base, si tratta di un passaggio diretto a un provider di servizi.

Sintassi

LONG lineSetCallQualityOfService(
  HCALL  hCall,
  LPVOID lpSendingFlowspec,
  DWORD  dwSendingFlowspecSize,
  LPVOID lpReceivingFlowspec,
  DWORD  dwReceivingFlowspecSize
);

Parametri

hCall

Gestire la chiamata. L'applicazione deve avere privilegi OWNER.

lpSendingFlowspec

Puntatore alla memoria contenente una struttura FLOWPEC seguita da dati specifici del provider. La parte specifica del provider che segue la struttura FLOWPEC non deve contenere puntatori ad altri blocchi di memoria nel processo dell'applicazione, perché TAPI non saprà come eseguire il marshalling dei dati puntati dai puntatori privati e trasmetterlo tramite la comunicazione tra processi al provider di servizi.

dwSendingFlowspecSize

Dimensioni totali della struttura FLOWPEC e dei dati specifici del provider, in byte. Equivale a ciò che sarebbe stato archiviato in SendingFlowspec in una struttura QOS .

lpReceivingFlowspec

Puntatore alla memoria contenente una struttura FLOWPEC seguita da dati specifici del provider. La parte specifica del provider che segue la struttura FLOWPEC non deve contenere puntatori ad altri blocchi di memoria nel processo dell'applicazione, perché TAPI non saprà come eseguire il marshalling dei dati puntati dai puntatori privati e trasmetterlo tramite la comunicazione tra processi al provider di servizi.

dwReceivingFlowspecSize

Dimensioni totali dei FLUSSIPEC e dei dati specifici del provider, in byte. Ciò equivale a quello che sarebbe stato archiviato in ReceivingFlowspec in una struttura QOS .

Valore restituito

Restituisce un identificatore di richiesta positivo se l'operazione asincrona viene avviata; in caso contrario, la funzione restituisce uno dei valori di errore negativi seguenti:

LINEERR_INVALCALLHANDLE, LINEERR_INVALCALLSTATE, LINEERR_INVALPARAM, LINEERR_INVALPOINTER LINEERR_NOMEM, LINEERR_INVALRATE, LINEERR_NOTOWNER, LINEERR_OPERATIONUNAVAIL, LINEERR_OPERATIONFAILED LINEERR_RATEUNAVAIL, LINEERR_OPERATIONFAILED, LINEERR_RESOURCEUNAVAIL, LINEERR_UNINITIALIZED.

Requisiti

Piattaforma di destinazione	Windows
Intestazione	tapi.h
Libreria	Tapi32.lib
DLL	Tapi32.dll

Vedi anche

FLOWPEC

QOS

Funzioni di servizio linea supplementari

Panoramica di riferimento su TAPI 2.2