lineGetID 関数 (tapi.h)

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

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"。