TSPI_lineDevSpecific関数 (tspi.h)
TSPI_lineDevSpecific関数は、サービス プロバイダーが他の操作で説明されていない機能へのアクセスを提供できるようにするための一般的な拡張メカニズムとして使用されます。 拡張機能の意味はデバイス固有であり、これらの拡張機能を利用するには、アプリケーションがそれらを完全に認識する必要があります。
構文
LONG TSPIAPI TSPI_lineDevSpecific(
DRV_REQUESTID dwRequestID,
HDRVLINE hdLine,
DWORD dwAddressID,
HDRVCALL hdCall,
LPVOID lpParams,
DWORD dwSize
);
パラメーター
dwRequestID
非同期要求の識別子。
hdLine
操作する行に対するサービス プロバイダーのハンドル。
dwAddressID
操作対象の指定された行のアドレス。 アドレス識別子は、アドレスに永続的に関連付けられます。識別子はオペレーティング システムのアップグレード全体で一定のままです。
hdCall
操作する呼び出しに対するサービス プロバイダーのハンドル。 このフィールドの値は NULL である可能性があります。 hdCall の呼び出し状態はデバイス固有です。
lpParams
パラメーター ブロックを保持するために使用されるメモリ領域へのポインター。 このパラメーター ブロックの形式は、デバイス固有です。
dwSize
パラメーター ブロック領域のサイズ (バイト単位)。 lpParams パラメーターが文字列へのポインターである場合、サイズには null ターミネータを含める必要があります。
戻り値
エラーが発生した場合は 、dwRequestID またはエラー番号を返します。 対応するASYNC_COMPLETIONの lResult 実際のパラメーターは、関数が成功した場合は 0、エラーが発生した場合はエラー番号です。 可能な戻り値は次のとおりです。
LINEERR_INVALLINEHANDLE、LINEERR_OPERATIONUNAVAIL、LINEERR_INVALADDRESSID、LINEERR_OPERATIONFAILED、LINEERR_NOMEM、LINEERR_RESOURCEUNAVAIL。
注釈
追加の戻り値は、デバイス固有です。
この操作では、ジェネリック パラメーター プロファイルが提供されます。 パラメーター構造の解釈は、デバイス固有です。 TAPI は常に hdLine パラメーターを指定します。 dwAddressID と hdCall のどちらを有効と想定するかは、デバイス固有です。 指定する場合は、 hdLine に属している必要があります。 デバイス固有のアプリケーションに返送された表示と応答では、 LINE_DEVSPECIFIC メッセージが使用されます。
この関数は、TAPI 関数 lineDevSpecific を呼び出すアプリケーションに直接応答して呼び出されます。 TAPI は、TAPI レベルで使用される hLine パラメーターと hdCall パラメーターを、TSPI レベルで使用される対応する hdLine パラメーターと hdCall パラメーターに変換します。 lpParams バッファーは変更されていない状態で渡されます。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | Windows |
| ヘッダー | tspi.h |