次の方法で共有


lineSetDevConfig 関数 (tapi.h)

lineSetDevConfig 関数を使用すると、アプリケーションは、ライン デバイス上のメディア ストリーム デバイスの構成を、lineGetDevConfig を使用して以前に取得したセットアップに復元できます。 たとえば、この構造体の内容では、回線に関連付けられている "datamodem" メディア デバイスのデータ レート、文字形式、変調方式、およびエラー制御プロトコル設定を指定できます。

構文

LONG lineSetDevConfig(
  DWORD        dwDeviceID,
  LPVOID const lpDeviceConfig,
  DWORD        dwSize,
  LPCSTR       lpszDeviceClass
);

パラメーター

dwDeviceID

構成する回線デバイスの識別子。

lpDeviceConfig

VARSTRING 構造体の変数部分で lineGetDevConfig によって返された不透明な構成データ構造へのポインター。

dwSize

lpDeviceConfig が指す構造体内のバイト数。 この値は、lineGetDevConfig によって返される VARSTRING 構造体の dwStringSize メンバーで返されます。

lpszDeviceClass

構成を設定するデバイスのデバイス クラスを指定する null で終わる文字列へのポインター。 有効なデバイス クラス文字列は、 lineGetID 関数に指定されているものと同じです。

戻り値

関数が成功した場合は 0 を返し、エラーが発生した場合は負のエラー番号を返します。 可能な戻り値は次のとおりです。

LINEERR_BADDEVICEID、LINEERR_NODRIVER、LINEERR_INVALDEVICECLASS、LINEERR_OPERATIONUNAVAIL、LINEERR_INVALPOINTER、LINEERR_OPERATIONFAILED、LINEERR_INVALPARAM、LINEERR_RESOURCEUNAVAIL、LINEERR_INVALLINESTATE、LINEERR_UNINITIALIZED、LINEERR_NOMEM、LINEERR_NODEVICE。

注釈

通話の状態はデバイス固有です。

通常、アプリケーションは lineGetID を 呼び出して回線に関連付けられているメディア ストリーム デバイスを識別し、 lineConfigDialog を呼び出してユーザーがデバイス構成を設定できるようにします。 その後、 lineGetDevConfig を呼び出し、特定の通話先に関連付けられている電話帳またはその他のデータベースに構成情報を保存できます。 ユーザーが同じ宛先をもう一度呼び出す場合は、この lineSetDevConfig 関数を使用して、ユーザーが選択した構成設定を復元できます。 lineSetDevConfiglineConfigDialogおよび lineGetDevConfig 関数をこの順序で使用して、ユーザーが設定を表示および更新できるようにします。

構造体に含まれるデータの正確な形式は、行およびメディア ストリーム API (デバイス クラス) に固有であり、文書化されておらず、未定義です。 アプリケーションは、コンテンツを直接操作せず、"不透明" として扱う必要があります。 一般に、この関数を使用して構造体を送信できるのは、その構造体が取得されたのと同じデバイスに限られます。 ただし、一部のテレフォニー サービス プロバイダーでは、同一のデバイス間 (つまり、同じマルチポート モデム カード上の複数のポート) 間で構造体を交換できる場合があります。 同じデバイス クラスのデバイスであっても、このような互換性は保証されません。

一部のサービス プロバイダーでは、呼び出しがアクティブな間に構成の設定を許可する場合もあれば、設定できないサービス プロバイダーもあります。

要件

要件
対象プラットフォーム Windows
ヘッダー tapi.h
Library Tapi32.lib
[DLL] Tapi32.dll

こちらもご覧ください

基本的なテレフォニー サービス リファレンス

TAPI 2.2 リファレンスの概要

VARSTRING

lineConfigDialog

lineGetDevConfig

lineGetID