lineGetDevConfig 関数は、"不透明" データ構造オブジェクトを返します。このオブジェクトの内容は、行 (サービス プロバイダー) とデバイス クラスに固有です。 データ構造オブジェクトは、ライン デバイスに関連付けられているメディア ストリーム デバイスの現在の構成を格納します。
構文
LONG lineGetDevConfigW(
DWORD dwDeviceID,
LPVARSTRING lpDeviceConfig,
LPCWSTR lpszDeviceClass
);
パラメーター
dwDeviceID
構成する回線デバイスの識別子。
lpDeviceConfig
デバイス構成構造が返される VARSTRING
構造体のサイズ パラメーターが正しくない場合、データが上書きされる可能性があります。 構造体サイズの設定の詳細については、メモリ割り当て トピックを参照してください。
lpszDeviceClass
構成が要求されるデバイスのデバイス クラスを指定する null で終わる文字列へのポインター。 lineGetID 文字列
戻り値
関数が成功した場合は 0 を返し、エラーが発生した場合は負のエラー番号を返します。 可能な戻り値は次のとおりです。
LINEERR_BADDEVICEID、LINEERR_NODRIVER、LINEERR_INVALDEVICECLASS、LINEERR_OPERATIONUNAVAIL、LINEERR_INVALPOINTER、LINEERR_RESOURCEUNAVAIL、LINEERR_STRUCTURETOOSMALL、LINEERR_OPERATIONFAILED、LINEERR_NOMEM、LINEERR_UNINITIALIZED、LINEERR_NODEVICE。
備考
通話状態はデバイス固有です。
lineGetDevConfig 関数を使用すると、特定の回線デバイスに関連付けられているメディア ストリーム デバイスの構成を指定するデータ構造を TAPI から取得できます。 たとえば、この構造体の内容では、行に関連付けられている "datamodem" メディア デバイスのデータ レート、文字形式、変調方式、およびエラー制御プロトコルの設定を指定できます。
通常、アプリケーションは lineGetID
構造体に含まれるデータの正確な形式は、行とメディア ストリーム API (デバイス クラス) に固有であり、文書化されておらず、未定義です。 この関数によって返される構造体は、アプリケーションによって直接アクセスまたは操作することはできませんが、そのまま保存することしかできず、後で設定を復元するために lineSetDevConfig
手記
tapi.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして lineGetDevConfig を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| ターゲット プラットフォーム の |
ウィンドウズ |
| ヘッダー | tapi.h |
| ライブラリ | Tapi32.lib |
| DLL | Tapi32.dll |
関連項目
VARSTRING を
lineConfigDialog を
lineGetID を
lineSetDevConfig を