funzione TSPI_lineSetCallQualityOfService (tspi.h)

Il provider di servizi di funzione TSPI_lineSetCallQualityOfService tenta di rinegoziare il QOS nella chiamata con l'opzione Se il QOS desiderato non è disponibile, la funzione ha esito negativo, ma la chiamata continua con il QOS precedente. Se la funzione ha esito positivo, le nuove informazioni QOS vengono archiviate in LINECALLINFO; un messaggio LINECALLINFOSTATE_QOS viene inviato dal provider di servizi per indicare i valori aggiornati.

Sintassi

LONG TSPIAPI TSPI_lineSetCallQualityOfService(
  DRV_REQUESTID dwRequestID,
  HDRVCALL      hdCall,
  LPVOID        lpSendingFlowspec,
  DWORD         dwSendingFlowspecSize,
  LPVOID        lpReceivingFlowspec,
  DWORD         dwReceivingFlowspecSize
);

Parametri

dwRequestID

Identificatore per la creazione di report dei risultati delle funzioni asincrone.

hdCall

Handle del provider di servizi alla chiamata.

lpSendingFlowspec

Puntatore alla memoria contenente una struttura FLOWPEC WinSock2 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 sa come eseguire il marshalling dei dati puntati dai puntatori privati e trasmetterlo tramite la comunicazione tra processi al provider di servizi.

dwSendingFlowspecSize

Dimensioni totali in byte di FLOWPEC e dati specifici del provider, equivalenti a quelli archiviati in SendingFlowspec.len in una struttura QOSOS WinSock2 .

lpReceivingFlowspec

Puntatore alla memoria contenente una struttura FLOWPEC WinSock2 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 sa come eseguire il marshalling dei dati puntati dai puntatori privati e trasmetterlo tramite la comunicazione tra processi al provider di servizi.

dwReceivingFlowspecSize

Dimensioni totali in byte di FLOWPEC e dati specifici del provider, equivalenti a quelli archiviati in ReceivingFlowspec.len in una struttura QOSock2 WinSock2 .

Valore restituito

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

LINEERR_INVALCALLSTATE, LINEERR_INVALRATE, LINEERR_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_RATEUNAVAIL, LINEERR_RESOURCEUNAVAIL.

Requisiti

Vedi anche

LINECALLINFO