phoneGetID 関数 (tapi.h)
phoneGetID 関数は、指定された電話デバイスに関連付けられている特定のデバイス クラスのデバイス識別子を返します。
構文
LONG phoneGetID(
HPHONE hPhone,
LPVARSTRING lpDeviceID,
LPCSTR lpszDeviceClass
);
パラメーター
hPhone
開いている電話デバイスへのハンドル。
lpDeviceID
デバイス識別子が返される VARSTRING 型のデータ構造へのポインター。 要求が正常に完了すると、この場所にはデバイス識別子が入力されます。 返される情報の形式は、デバイスの名前付けにデバイス クラス (API) によって使用されるメソッドによって異なります。
lpszDeviceClass
識別子が要求されたデバイスのデバイス クラスを指定する null で終わる文字列へのポインター。 有効なデバイス クラス文字列は、デバイス クラスを識別するために System.ini セクションで使用される文字列です。
戻り値
要求が成功した場合は 0 を返し、エラーが発生した場合は負のエラー番号を返します。 可能な戻り値は次のとおりです。
PHONEERR_INVALPHONEHANDLE、PHONEERR_NOMEM、PHONEERR_INVALPOINTER、PHONEERR_RESOURCEUNAVAIL、PHONEERR_INVALDEVICECLASS、PHONEERR_UNINITIALIZED、PHONEERR_OPERATIONFAILED、PHONEERR_STRUCTURETOOSMALL、PHONEERR_OPERATIONUNAVAIL。
注釈
phoneGetID 関数を使用すると、電話ハンドルを指定して電話デバイス識別子を取得できます。 また、開いている電話デバイスに関連付けられているメディア デバイスのデバイス識別子 (COM、ウェーブ、MIDI、電話、回線、NDIS などのデバイス クラスの場合) を取得するためにも使用できます。 これらのデバイス クラスの名前では、大文字と小文字は区別されません。 その後、この識別子を適切なメディア API と共に使用して、対応するデバイスを選択できます。
デバイス クラス名については、「 TAPI デバイス クラス 」を参照してください。
デバイス固有のメディアの種類を定義するベンダーは、メディアの種類のデバイスを管理するために、対応するデバイス固有の (独自の) API を定義する必要もあります。 異なるベンダーによって個別に割り当てられたデバイス クラス名の競合を回避するために、ベンダーは、ベンダーとそれに続くメディアの種類の両方を一意に識別する名前を選択する必要があります。 例: "intel/video"。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | Windows |
| ヘッダー | tapi.h |
| Library | Tapi32.lib |
| [DLL] | Tapi32.dll |