次の方法で共有


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

デバイス構成情報を含むバイト配列へのポインター。

戻り値

このメソッドは、これらの値のいずれかを返すことができます。

リターン コード 説明
S_OK
メソッドが成功しました。
E_POINTER
pDeviceClasspdwSize、または ppDeviceConfig パラメーターが有効なポインターではありません。
E_OUTOFMEMORY
操作を実行するためのメモリが不足しています。

注釈

このメソッドは、 LineGetDevConfig TAPI 2.1 関数の COM ラッパーです。

GetID は、このメソッドを呼び出す前に実行する必要があります。

アプリケーションでは 、SysAllocString を使用して pDeviceClass パラメーターのメモリを割り当て、 SysFreeString を使用して変数が不要になったときにメモリを解放する必要があります。

アプリケーションで CoTaskMemFree 関数を呼び出して、 ppDeviceConfig パラメーターに割り当てられたメモリを解放する必要があります。

TAPI 2.1 相互参照: lineGetDevConfiglineSetDevConfig

要件

要件
対象プラットフォーム Windows
ヘッダー tapi3if.h (Tapi3.h を含む)
Library Uuid.lib
[DLL] Tapi3.dll

こちらもご覧ください

ITLegacyAddressMediaControl

ITLegacyCallMediaControl

SetDevConfig