lineSetDevConfig 関数 (tapi.h)

[アーティクル]
03/13/2024

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 関数を使用して、ユーザーが選択した構成設定を復元できます。 lineSetDevConfig、lineConfigDialog、および lineGetDevConfig 関数をこの順序で使用して、ユーザーが設定を表示および更新できるようにします。

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

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