phoneGetRing 関数 (tapi.h)
phoneGetRing 関数を使用すると、アプリケーションは、現在のリング モードに関して、指定された開いている電話デバイスに対してクエリを実行できます。
構文
LONG phoneGetRing(
HPHONE hPhone,
LPDWORD lpdwRingMode,
LPDWORD lpdwVolume
);
パラメーター
hPhone
開いている電話デバイスにハンドルします。
lpdwRingMode
電話が呼び出されている呼び出しパターン。 ゼロは、電話が呼び出されていないことを示します。
lpdwVolume
電話が鳴る音量レベル。 これは、0x0000FFFF (最大ボリューム) に0x00000000 (無音) の範囲内の数値です。 この範囲のボリューム設定の実際の粒度と量子化は、サービス プロバイダー固有です。
戻り値
要求が成功した場合は 0 を返し、エラーが発生した場合は負のエラー番号を返します。 可能な戻り値は次のとおりです。
PHONEERR_INVALPHONEHANDLE、PHONEERR_NOMEM、PHONEERR_INVALPHONESTATE、PHONEERR_RESOURCEUNAVAIL、PHONEERR_INVALPOINTER、PHONEERR_OPERATIONFAILED、PHONEERR_OPERATIONUNAVAIL、PHONEERR_UNINITIALIZED。
注釈
サービス プロバイダーは、電話の各リング モードに対応する実際の可聴呼び出しパターンを定義します。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | Windows |
| ヘッダー | tapi.h |
| Library | Tapi32.lib |
| [DLL] | Tapi32.dll |