TSPI_lineDevSpecificFeature関数 (tspi.h)
TSPI_lineDevSpecificFeature関数は、サービス プロバイダーが他の操作で説明されていない機能へのアクセスを提供できるようにするための拡張メカニズムとして使用されます。 これらの拡張機能の意味はデバイス固有であり、これらの拡張機能を利用するには TAPI またはそのクライアント アプリケーションがそれらを完全に認識する必要があります。
構文
LONG TSPIAPI TSPI_lineDevSpecificFeature(
DRV_REQUESTID dwRequestID,
HDRVLINE hdLine,
DWORD dwFeature,
LPVOID lpParams,
DWORD dwSize
);
パラメーター
dwRequestID
非同期要求の識別子。
hdLine
回線デバイスに対するサービス プロバイダーのハンドル。
dwFeature
回線デバイスで呼び出す機能。 このパラメーターでは 、PHONEBUTTONFUNCTION_定数を使用します。
lpParams
機能に依存するパラメーター ブロックを保持するために使用されるメモリ領域へのポインター。 このパラメーター ブロックの形式は、デバイス固有です。
dwSize
バッファーのサイズ (バイト単位)。 lpParams パラメーターが文字列へのポインターである場合、サイズには null ターミネータを含める必要があります。
戻り値
エラーが発生した場合は 、dwRequestID またはエラー番号を返します。 対応するASYNC_COMPLETIONの lResult 実際のパラメーターは、関数が成功した場合は 0、エラーが発生した場合はエラー番号です。 可能な戻り値は次のとおりです。
LINEERR_INVALFEATURE、LINEERR_OPERATIONUNAVAIL、LINEERR_INVALLINEHANDLE、LINEERR_OPERATIONFAILED、LINEERR_NOMEM、LINEERR_RESOURCEUNAVAIL。
注釈
追加の戻り値は、デバイス固有です。 hdCall の呼び出し状態はデバイス固有です。
この関数は、TAPI アプリケーションに電話機能ボタン エミュレーション機能を提供します。 TAPI は、クライアント アプリケーションの代わりにこの操作を呼び出すときに、"ボタンを押す" イベントに相当するものを指定します。 この機能の呼び出し方法は、API によってその意味が定義されないため、デバイスに大きく依存します。 アプリケーションがデバイス固有の拡張機能に依存している場合、アプリケーションは他のサービス プロバイダー環境に適切に移植されません。
この関数は、TAPI lineDevSpecificFeature 関数を呼び出すアプリケーションに直接応答して呼び出されます。 TAPI は、TAPI レベルで使用される hLine パラメーターを、TSPI レベルで使用される対応する hdLine パラメーターに変換します。 lpParams バッファーは、変更されていない状態で渡されます。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | Windows |
| ヘッダー | tspi.h |