phoneGetID 関数は、指定した電話デバイスに関連付けられている特定のデバイス クラスのデバイス識別子を返します。
構文
LONG phoneGetIDA(
HPHONE hPhone,
LPVARSTRING lpDeviceID,
LPCSTR lpszDeviceClass
);
パラメーター
hPhone
開いている電話デバイスへのハンドル。
lpDeviceID
デバイス識別子が返される VARSTRING
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"。
手記
tapi.h ヘッダーは、unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして phoneGetID を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| ターゲット プラットフォーム の |
ウィンドウズ |
| ヘッダー | tapi.h |
| ライブラリ | Tapi32.lib |
| DLL | Tapi32.dll |
関連項目
VARSTRING を