TSPI_phoneGetID関数 (tspi.h)
TSPI_phoneGetID関数は、指定した電話デバイスに関連付けられている特定のデバイス クラスのデバイス識別子を返します。
構文
LONG TSPIAPI TSPI_phoneGetID(
HDRVPHONE hdPhone,
LPVARSTRING lpDeviceID,
LPCWSTR lpszDeviceClass,
HANDLE hTargetProcess
);
パラメーター
hdPhone
照会する電話へのハンドル。
lpDeviceID
デバイス識別子が返される VARSTRING 型のデータ構造へのポインター。 返される情報の形式は、デバイスの名前付けにデバイス クラス (API) によって使用されるメソッドによって異なります。 アプリケーションは、TSPI_phoneGetIDを呼び出す前に、この構造体の dwTotalSize メンバーを設定して、情報を返すために TAPI が使用できるメモリの量を示します。
lpszDeviceClass
識別子が要求されたデバイスのデバイス クラスを指定する、null で終わる Unicode 文字列へのポインター。
hTargetProcess
TSPI_phoneGetID関数が呼び出されるアプリケーションのプロセス ハンドル。 VARSTRING 構造体で返される情報にアプリケーションで使用するハンドルが含まれている場合、サービス プロバイダーはプロセスのハンドルを作成または複製します。
戻り値
関数が成功した場合は 0 を返し、エラーが発生した場合はエラー番号を返します。 可能な戻り値は次のとおりです。
PHONEERR_INVALPHONEHANDLE、PHONEERR_RESOURCEUNAVAIL、PHONEERR_INVALDEVICECLASS、PHONEERR_OPERATIONFAILED、PHONEERR_NOMEM、PHONEERR_OPERATIONUNAVAIL。
注釈
この操作を使用して、電話ハンドルを指定して電話デバイス識別子を取得できます。 また、開いている電話デバイスに関連付けられているメディア デバイスのデバイス識別子 (COM、ウェーブ、MIDI、電話、回線、mciwave などのデバイス クラスの場合) を取得するためにも使用できます。 その後、この識別子を適切なメディア API (mci、midi、wav など) と共に使用して、対応するデバイスを選択できます。 一般的なデバイス クラス名の詳細については、「 TSPI デバイス クラス」を参照してください。
サービス プロバイダーは、TAPI によって入力される dwTotalSize を除き、VARSTRING データ構造のすべてのメンバーを入力します。 サービス プロバイダーは dwTotalSize メンバーを上書きしないでください。
サービス プロバイダーは、tapi/line および tapi/phone デバイス クラスを処理する必要はありません。これは、TAPI がサービス プロバイダーに対してこれらを処理するためです。 したがって、これらのデバイス クラスを処理するためのコードは省略可能です。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | Windows |
| ヘッダー | tspi.h |