TSPI_lineGetAddressCaps関数 (tspi.h)

  • [アーティクル]

TSPI_lineGetAddressCaps関数は、指定した回線デバイスの指定されたアドレスに対してクエリを実行して、テレフォニー機能を判断します。

構文

LONG TSPIAPI TSPI_lineGetAddressCaps(
  DWORD             dwDeviceID,
  DWORD             dwAddressID,
  DWORD             dwTSPIVersion,
  DWORD             dwExtVersion,
  LPLINEADDRESSCAPS lpAddressCaps
);

パラメーター

dwDeviceID

クエリを実行するアドレスを含む回線デバイス。

dwAddressID

クエリを実行する機能を持つ、指定された回線デバイス上のアドレス。 アドレス識別子は、アドレスに永続的に関連付けられます。識別子はオペレーティング システムのアップグレード全体で一定のままです。 このパラメーターは、この関数が呼び出されたときに TAPI によって検証されません。

dwTSPIVersion

使用するテレフォニー SPI のバージョン番号。 上位の単語にはメジャー バージョン番号が含まれています。下位ワードにはマイナー バージョン番号が含まれています。

dwExtVersion

使用するサービス プロバイダー固有の拡張機能のバージョン番号。 デバイス固有の拡張機能を使用しない場合、この数値は 0 です。 それ以外の場合、上位の単語にはメジャー バージョン番号が含まれます。下位ワードにはマイナー バージョン番号が含まれています。 このパラメーターは、この関数が呼び出されたときに TAPI によって検証されません。

lpAddressCaps

LINEADDRESSCAPS 型の可変サイズの構造体へのポインター。 要求が正常に完了すると、この構造体にはアドレス機能情報が入力されます。

戻り値

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

LINEERR_INCOMPATIBLEAPIVERSION、LINEERR_NOMEM、LINEERR_INCOMPATIBLEEXTVERSION、LINEERR_OPERATIONUNAVAIL、LINEERR_INVALADDRESSID、LINEERR_OPERATIONFAILED、LINEERR_NODRIVER、LINEERR_RESOURCEUNAVAIL。

注釈

特定のドライバーでサポートされている行デバイス識別子は、TSPI_providerInit関数に渡される dwLineDeviceIDBase の値から順番に番号が付けられます。

サービス プロバイダーは、TAPI によって入力される dwTotalSize を除き、LINEADDRESSCAPS データ構造のすべてのメンバーを入力します。 サービス プロバイダーは dwTotalSize メンバーを上書きしないでください。

サービス プロバイダーが TSPI_lineGetAddressCaps 関数から戻った後、TAPI は LINEADDRESSCAPS 構造体の dwCallInfoStates メンバーと dwCallStates メンバーを次のように設定します。

LINEADDRESSCAPS.dwCallInfoStates |=
    LINECALLINFOSTATE_NUMOWNERINCR |
    LINECALLINFOSTATE_NUMOWNERDECR |
    LINECALLINFOSTATE_NUMMONITORS;

LINEADDRESSCAPS.dwCallStates |= LINECALLSTATE_UNKNOWN;

要件

要件 値
対象プラットフォーム Windows
ヘッダー tspi.h

こちらもご覧ください

LINEADDRESSCAPS

TSPI_providerInit