TSPI_providerEnumDevices関数 (tspi.h)

[アーティクル]
03/03/2024

TAPI は 、TSPI_providerInit する前に TSPI_providerEnumDevices 関数を呼び出して、サービスプロバイダーによってサポートされている回線デバイスと電話デバイスの数を決定します。

構文

LONG TSPIAPI TSPI_providerEnumDevices(
  DWORD      dwPermanentProviderID,
  LPDWORD    lpdwNumLines,
  LPDWORD    lpdwNumPhones,
  HPROVIDER  hProvider,
  LINEEVENT  lpfnLineCreateProc,
  PHONEEVENT lpfnPhoneCreateProc
);

パラメーター

dwPermanentProviderID

初期化中のサービスプロバイダーの、このシステム上のサービスプロバイダー内で一意の永続的な識別子。

lpdwNumLines

サービスプロバイダーがサポートするように構成されている回線デバイスの数を書き込む必要がある DWORD サイズのメモリ位置へのポインター。 TAPI は値を 0 に初期化するため、サービスプロバイダーが別の値の書き込みに失敗した場合、値 0 が想定されます。

lpdwNumPhones

サービスプロバイダーがサポートするように構成されている電話デバイスの数を書き込む必要がある DWORD サイズのメモリ位置へのポインター。 TAPI は値を 0 に初期化するため、サービスプロバイダーが別の値の書き込みに失敗した場合、値 0 が想定されます。

hProvider

テレフォニー環境のこの実行中に、このサービスプロバイダーのこのインスタンスを一意に識別する不透明な DWORD サイズの値。

lpfnLineCreateProc

TAPI によって提供される LINEEVENT コールバックプロシージャへのポインター。サービスプロバイダーは、この関数を使用して、新しい回線デバイスを作成する必要があるときに LINE_CREATEメッセージを送信します。

lpfnPhoneCreateProc

TAPI によって提供される PHONEEVENT コールバックプロシージャへのポインター。サービスプロバイダーは、この関数を使用して、新しい電話デバイスを作成する必要があるときに PHONE_CREATEメッセージを送信します。

戻り値

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

LINEERR_NOMEM、LINEERR_OPERATIONFAILED。

注釈

TAPI の以前のバージョンでは、この関数の実装は省略可能でした。 TAPI 2.0 以降では、この関数の実装はすべてのサービスプロバイダーで必須です。 TAPI は、TAPI スタートアップ時に Telephon.ini またはレジストリをチェックして、サービスプロバイダーがサポートする回線と電話機の初期数を決定しなくなりました。

TSPI_providerInitプロシージャが完了する前に、新しいデバイスを表示できます。 TAPI は、プロバイダーの初期化中に_CREATEメッセージを適切に処理します。