lineSetCallQualityOfService-Funktion (tapi.h)

Artikel
08/26/2023

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.