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 |