lineGetID 関数は、選択した行、アドレス、または呼び出しに関連付けられている指定されたデバイス クラスのデバイス識別子を返します。
構文
LONG lineGetIDA(
HLINE hLine,
DWORD dwAddressID,
HCALL hCall,
DWORD dwSelect,
LPVARSTRING lpDeviceID,
LPCSTR lpszDeviceClass
);
パラメーター
hLine
開いているライン デバイスへのハンドル。
dwAddressID
指定されたオープンライン デバイス上のアドレス。 アドレス識別子は、アドレスに永続的に関連付けられます。識別子はオペレーティング システムのアップグレード間で一定のままです。
hCall
呼び出しへのハンドル。
dwSelect
要求されたデバイス識別子が、回線、アドレス、または 1 回の呼び出しのいずれに関連付けられているかを指定します。 このパラメーターは、LINECALLSELECT_ 定数1 つだけを使用します。
lpDeviceID
デバイス識別子が返される VARSTRING
構造体のサイズ パラメーターが正しくない場合、データが上書きされる可能性があります。 構造体サイズの設定の詳細については、メモリ割り当て トピックを参照してください。
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
デバイス クラス名 TAPI デバイス クラスの を参照してください。
デバイス固有のメディア モードを定義するベンダーは、メディア モードのデバイスを管理するために、対応するデバイス固有 (専用) API も定義する必要があります。 異なるベンダーによって個別に割り当てられたデバイス クラス名の競合を回避するには、ベンダーと、それに続くメディアの種類の両方を一意に識別する名前をベンダーが選択する必要があります。 例: "intel/video"。
手記
tapi.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして lineGetID を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| ターゲット プラットフォーム の |
ウィンドウズ |
| ヘッダー | tapi.h |
| ライブラリ | Tapi32.lib |
| DLL | Tapi32.dll |
関連項目
VARSTRING を