lineSetCallQualityOfService 関数 (tapi.h)
lineSetCallQualityOfService 関数を使用すると、アプリケーションは既存の呼び出しのサービス 品質パラメーター (予約容量とパフォーマンス保証) の変更を試みることができます。 基本的なパラメーター検証を除き、これはサービス プロバイダーへの直接のパススルーです。
構文
LONG lineSetCallQualityOfService(
HCALL hCall,
LPVOID lpSendingFlowspec,
DWORD dwSendingFlowspecSize,
LPVOID lpReceivingFlowspec,
DWORD dwReceivingFlowspecSize
);
パラメーター
hCall
呼び出しを処理します。 アプリケーションには OWNER 特権が必要です。
lpSendingFlowspec
FLOWSPEC 構造体の後にプロバイダー固有のデータが続くメモリへのポインター。 FLOWSPEC 構造体の後のプロバイダー固有の部分には、アプリケーション プロセス内の他のメモリ ブロックへのポインターを含めてはいけません。TAPI は、プライベート ポインターによって指されるデータをマーシャリングし、サービス プロバイダーへのプロセス間通信を通じてデータを伝達する方法を認識しないためです。
dwSendingFlowspecSize
FLOWSPEC 構造体とそれに付随するプロバイダー固有データの合計サイズ (バイト単位)。 これは、QoS 構造体の SendingFlowspec に格納されたものと同じです。
lpReceivingFlowspec
FLOWSPEC 構造体の後にプロバイダー固有のデータが続くメモリへのポインター。 FLOWSPEC 構造体の後のプロバイダー固有の部分には、アプリケーション プロセス内の他のメモリ ブロックへのポインターを含めてはいけません。TAPI は、プライベート ポインターによって指されるデータをマーシャリングし、サービス プロバイダーへのプロセス間通信を通じてデータを伝達する方法を認識しないためです。
dwReceivingFlowspecSize
FLOWSPEC とそれに付随するプロバイダー固有データの合計サイズ (バイト単位)。 これは、QOS 構造体の ReceivingFlowspec に格納されたものと同じです。
戻り値
非同期操作が開始された場合は、正の要求識別子を返します。それ以外の場合、関数は次のいずれかの負のエラー値を返します。
LINEERR_INVALCALLHANDLE、LINEERR_INVALCALLSTATE、LINEERR_INVALPARAM、LINEERR_INVALPOINTER、LINEERR_INVALRATE、LINEERR_NOMEM、LINEERR_NOTOWNER、LINEERR_OPERATIONUNAVAIL、LINEERR_OPERATIONFAILED、LINEERR_RATEUNAVAIL、LINEERR_RESOURCEUNAVAIL、LINEERR_UNINITIALIZED。
要件
| 対象プラットフォーム | Windows |
| ヘッダー | tapi.h |
| Library | Tapi32.lib |
| [DLL] | Tapi32.dll |