ITLegacyAddressMediaControl::GetDevConfig メソッド (tapi3if.h)
GetDevConfig メソッドは、不透明なデータ構造を返します。 正確な内容は、サービス プロバイダーとデバイス クラスに固有です。 データ構造は、特定の回線デバイスに関連付けられているデバイスの構成を指定します。 たとえば、この構造体の内容では、回線に関連付けられている datamodem デバイスのデータ レート、文字形式、変調方式、およびエラー制御プロトコル設定を指定できます。
構文
HRESULT GetDevConfig(
[in] BSTR pDeviceClass,
[out] DWORD *pdwSize,
[out] BYTE **ppDeviceConfig
);
パラメーター
[in] pDeviceClass
構成情報が必要な TAPI デバイス クラスを含む BSTR へのポインター。
[out] pdwSize
構成配列のサイズへのポインター。
[out] ppDeviceConfig
デバイス構成情報を含むバイト配列へのポインター。
戻り値
このメソッドは、これらの値のいずれかを返すことができます。
リターン コード | 説明 |
---|---|
|
メソッドが成功しました。 |
|
pDeviceClass、pdwSize、または ppDeviceConfig パラメーターが有効なポインターではありません。 |
|
操作を実行するためのメモリが不足しています。 |
注釈
このメソッドは、 LineGetDevConfig TAPI 2.1 関数の COM ラッパーです。
GetID は、このメソッドを呼び出す前に実行する必要があります。
アプリケーションでは 、SysAllocString を使用して pDeviceClass パラメーターのメモリを割り当て、 SysFreeString を使用して変数が不要になったときにメモリを解放する必要があります。
アプリケーションで CoTaskMemFree 関数を呼び出して、 ppDeviceConfig パラメーターに割り当てられたメモリを解放する必要があります。
TAPI 2.1 相互参照: lineGetDevConfig、 lineSetDevConfig
要件
要件 | 値 |
---|---|
対象プラットフォーム | Windows |
ヘッダー | tapi3if.h (Tapi3.h を含む) |
Library | Uuid.lib |
[DLL] | Tapi3.dll |