TUISPI_phoneConfigDialog関数 (tspi.h)

TUISPI_phoneConfigDialog関数を使用すると、指定した電話デバイスのプロバイダーは、hwndOwner の子ウィンドウとしてモーダル ダイアログ ボックスを表示し、ユーザーが電話デバイスに関連するパラメーターを構成できるようにします。 この関数を使用すると、バージョン 2.0 以降 (バージョン 1.4 以前でサポート) で TSPI_phoneConfigDialog 関数が廃止されます。

実装は省略可能です。

構文

LONG TSPIAPI TUISPI_phoneConfigDialog(
  TUISPIDLLCALLBACK lpfnUIDLLCallback,
  DWORD             dwDeviceID,
  HWND              hwndOwner,
  LPCWSTR           lpszDeviceClass
);

パラメーター

lpfnUIDLLCallback

UI DLL が呼び出すことができる関数へのポインターを使用して、サービス プロバイダー DLL と通信して、ダイアログ ボックスを表示し、更新された構成をサービス プロバイダーに送信するために必要な情報を取得できます。

dwDeviceID

構成する電話デバイス。

hwndOwner

ダイアログ ボックス ウィンドウを配置する親ウィンドウへのハンドル。

lpszDeviceClass

デバイス クラス名を識別する null で終わる Unicode 文字列へのポインター。 このデバイス クラスを使用すると、呼び出し元は、そのデバイス クラスに適用できる構成情報の特定のサブ画面を選択できます。 このパラメーターが NULL または空の文字列の場合は、最上位レベルの構成ダイアログ ボックスが選択されます。

戻り値

関数が成功した場合は 0 を返し、エラーが発生した場合はエラー番号を返します。 可能な戻り値は次のとおりです。

PHONEERR_BADDEVICEID、PHONEERR_NOMEM、PHONEERR_INUSE、PHONEERR_OPERATIONFAILED、PHONEERR_INVALPARAM、PHONEERR_OPERATIONUNAVAIL、PHONEERR_INVALDEVICECLASS、PHONEERR_RESOURCEUNAVAIL。

注釈

lpszDeviceClass パラメーターを使用すると、アプリケーションは、ユーザーが関心のあるデバイス クラスに適用できる構成情報の特定のサブ画面を選択できます。 許可される文字列は、 TSPI_phoneGetIDの場合と同じです。

たとえば、電話が Comm API をサポートしている場合、comm/datamodem を lpszDeviceClass として渡すと、プロバイダーは Comm に関連するパラメーターを表示します (または、少なくとも、ユーザーが目的のパラメーターを検索する必要がないように、マルチレベル構成ダイアログ ボックス チェーン内の対応するポイントから開始します)。 プロバイダーが電話の最高レベルの構成を表示するには、 szDeviceClass パラメーターを "tapi/phone"、""、または NULL にする必要があります。

要件

こちらもご覧ください

PHONECAPS

TSPI_phoneGetID