lineSetCallQualityOfService-Funktion (tapi.h)
Mit der lineSetCallQualityOfService-Funktion kann die Anwendung versuchen, die Qualität der Dienstparameter (reservierte Kapazität und Leistungsgarantien) für einen vorhandenen Aufruf zu ändern. Mit Ausnahme der grundlegenden Parametervalidierung handelt es sich hierbei um eine direkte Passthrough-Instanz an einen Dienstanbieter.
Syntax
LONG lineSetCallQualityOfService(
HCALL hCall,
LPVOID lpSendingFlowspec,
DWORD dwSendingFlowspecSize,
LPVOID lpReceivingFlowspec,
DWORD dwReceivingFlowspecSize
);
Parameter
hCall
Handle für den Aufruf. Die Anwendung muss über die BERECHTIGUNG OWNER verfügen.
lpSendingFlowspec
Zeiger auf den Arbeitsspeicher, der eine FLOWSPEC-Struktur gefolgt von anbieterspezifischen Daten enthält. Der anbieterspezifische Teil, der der FLOWSPEC-Struktur folgt, darf keine Zeiger auf andere Speicherblöcke im Anwendungsprozess enthalten, da TAPI nicht weiß, wie die Daten gemarshallt werden, auf die die privaten Zeiger verweisen, und sie über die prozessübergreifende Kommunikation an den Dienstanbieter übertragen werden.
dwSendingFlowspecSize
Gesamtgröße der FLOWSPEC-Struktur und der zugehörigen anbieterspezifischen Daten in Bytes. Dies entspricht dem, was in SendingFlowspec in einer QOS-Struktur gespeichert worden wäre.
lpReceivingFlowspec
Zeiger auf den Arbeitsspeicher, der eine FLOWSPEC-Struktur gefolgt von anbieterspezifischen Daten enthält. Der anbieterspezifische Teil, der der FLOWSPEC-Struktur folgt, darf keine Zeiger auf andere Speicherblöcke im Anwendungsprozess enthalten, da TAPI nicht weiß, wie die Daten gemarshallt werden, auf die die privaten Zeiger verweisen, und sie über die prozessübergreifende Kommunikation an den Dienstanbieter übertragen werden.
dwReceivingFlowspecSize
Gesamtgröße der FLOWSPEC und der zugehörigen anbieterspezifischen Daten in Byte. Dies entspricht dem, was in ReceiveingFlowspec in einer QOS-Struktur gespeichert worden wäre.
Rückgabewert
Gibt einen positiven Anforderungsbezeichner zurück, wenn der asynchrone Vorgang gestartet wird. Andernfalls gibt die Funktion einen der folgenden negativen Fehlerwerte zurück:
LINEERR_INVALCALLHANDLE, LINEERR_INVALCALLSTATE, LINEERR_INVALPARAM, LINEERR_INVALPOINTER, LINEERR_INVALRATE, LINEERR_NOMEM, LINEERR_NOTOWNER, LINEERR_OPERATIONUNAVAIL, LINEERR_OPERATIONFAILED, LINEERR_RATEUNAVAIL, LINEERR_RESOURCEUNAVAIL, LINEERR_UNINITIALIZED.
Anforderungen
| Zielplattform | Windows |
| Kopfzeile | tapi.h |
| Bibliothek | Tapi32.lib |
| DLL | Tapi32.dll |