次の方法で共有


lineGetID 関数 (tapi.h)

lineGetID 関数は、選択した行、アドレス、または呼び出しに関連付けられている指定されたデバイス クラスのデバイス識別子を返します。

構文

LONG lineGetID(
  HLINE       hLine,
  DWORD       dwAddressID,
  HCALL       hCall,
  DWORD       dwSelect,
  LPVARSTRING lpDeviceID,
  LPCSTR      lpszDeviceClass
);

パラメーター

hLine

開線デバイスへのハンドル。

dwAddressID

指定されたオープンライン デバイスのアドレス。 アドレス識別子は、アドレスに永続的に関連付けられます。識別子はオペレーティング システムのアップグレード全体で一定のままです。

hCall

呼び出しを処理します。

dwSelect

要求されたデバイス識別子を回線、アドレス、または 1 回の呼び出しに関連付けるかどうかを指定します。 このパラメーターは、 LINECALLSELECT_定数の 1 つだけを使用します。

lpDeviceID

デバイス識別子が返される VARSTRING 型のメモリ位置へのポインター。 要求が正常に完了すると、この場所にはデバイス識別子が入力されます。 返される情報の形式は、デバイスの名前付けにデバイス クラス API によって使用されるメソッドによって異なります。 lineGetID を呼び出す前に、この構造体の dwTotalSize メンバーを設定して、TAPI が情報を返すために使用できるメモリの量を示す必要があります。

メモ 構造体のサイズ パラメーターが正しくない場合は、データが上書きされる可能性があります。 構造体のサイズの設定の詳細については、 メモリ割り当て に関するトピックを参照してください。
 

lpszDeviceClass

識別子が要求されたデバイスのデバイス クラスを指定する null で終わる文字列へのポインター。 有効なデバイス クラス文字列は、デバイス クラスを識別するために SYSTEM.INI セクションで使用される文字列です。

戻り値

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

LINEERR_INVALLINEHANDLE、LINEERR_NOMEM、LINEERR_INVALADDRESSID、LINEERR_OPERATIONUNAVAIL、LINEERR_INVALCALLHANDLE、LINEERR_OPERATIONFAILED、LINEERR_INVALCALLSELECT、LINEERR_INVALDEVICECLASS、LINEERR_RESOURCEUNAVAIL、LINEERR_INVALPOINTER、LINEERR_STRUCTURETOOSMALL、LINEERR_NODEVICE、LINEERR_UNINITIALIZED。

注釈

lineGetID 関数を使用すると、行ハンドルが指定されたときに、回線デバイス識別子を取得できます。 これは、 lineOpen がデバイス識別子として LINEMAPPER を使用して開かれた後に、開かれた回線の実際の回線デバイス識別子を決定するために役立ちます。 この関数は、通話、アドレス、または回線に関連付けられている電話デバイスまたはメディア デバイス (COM、ウェーブ、MIDI、電話、回線、NDIS などのデバイス クラスの場合) のデバイス識別子を取得するためにも使用できます。 この識別子は、適切な API (電話、MIDI、ウェーブなど) と共に使用して、指定された呼び出しに関連付けられている対応するメディア デバイスを選択できます。

デバイス クラス名については、「 TAPI デバイス クラス」を参照してください。

デバイス固有のメディア モードを定義するベンダーは、メディア モードのデバイスを管理するために、対応するデバイス固有 (独自の) API を定義する必要もあります。 異なるベンダーによって個別に割り当てられたデバイス クラス名の競合を回避するために、ベンダーは、ベンダーと、それに続くメディアの種類の両方を一意に識別する名前を選択する必要があります。 例: "intel/video"。

要件

要件
対象プラットフォーム Windows
ヘッダー tapi.h
Library Tapi32.lib
[DLL] Tapi32.dll

こちらもご覧ください

基本的なテレフォニー サービス リファレンス

TAPI 2.2 リファレンスの概要

VARSTRING

lineOpen