lineSetDevConfig 関数を使用すると、アプリケーションはライン デバイス上のメディア ストリーム デバイスの構成を、lineGetDevConfigを使用して以前に取得したセットアップに復元できます。 たとえば、この構造体の内容では、行に関連付けられている "datamodem" メディア デバイスのデータ レート、文字形式、変調方式、およびエラー制御プロトコルの設定を指定できます。
構文
LONG lineSetDevConfigA(
DWORD dwDeviceID,
LPVOID const lpDeviceConfig,
DWORD dwSize,
LPCSTR lpszDeviceClass
);
パラメーター
dwDeviceID
構成する回線デバイスの識別子。
lpDeviceConfig
VARSTRING 構造体の変数部分 lineGetDevConfig によって返された不透明な構成データ構造へのポインター。
dwSize
lpDeviceConfigが指す構造体
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
構造体に含まれるデータの正確な形式は、行とメディア ストリーム API (デバイス クラス) に固有であり、文書化されておらず、未定義です。 アプリケーションでは、コンテンツを直接操作せず、"不透明" として扱う必要があります。 一般に、この関数を使用して構造体を取得したのと同じデバイスにのみ送信できます。 ただし、一部のテレフォニー サービス プロバイダーでは、同じデバイス (つまり、同じマルチポート モデム カード上の複数のポート) 間で構造体を交換できる場合があります。 このような互換性は、同じデバイス クラスのデバイスであっても、どのような方法でも保証されません。
サービス プロバイダーによっては、呼び出しがアクティブな間に構成の設定を許可する場合もあれば、設定できないサービス プロバイダーもあります。
手記
tapi.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして lineSetDevConfig を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| ターゲット プラットフォーム の |
ウィンドウズ |
| ヘッダー | tapi.h |
| ライブラリ | Tapi32.lib |
| DLL | Tapi32.dll |
関連項目
VARSTRING を
lineConfigDialog を
lineGetDevConfig を
lineGetID を