lineGenerateDigits 関数は、指定したシグナリング モードを使用して、指定した呼び出しで指定した数字の生成をインバンド トーンとして開始します。 lpszDigits に対して
構文
LONG lineGenerateDigitsW(
HCALL hCall,
DWORD dwDigitMode,
LPCWSTR lpszDigits,
DWORD dwDuration
);
パラメーター
hCall
呼び出しを処理します。 アプリケーションは、呼び出しの所有者である必要があります。 hCall の呼び出し状態
dwDigitMode
これらの数字のシグナル通知に使用する形式。 dwDigitMode
lpszDigits
生成される数字を含む null終了文字バッファーへのポインター。 有効な文字は、dwDigitModesで指定
また、コンマ (,) も有効な文字です。 コンマは、区切られた前の数字と次の桁のシグナリングの間に余分な遅延を挿入します。 この一時停止の期間は構成が定義されており、回線デバイスの機能はこの期間を示します。 複数のコンマを使用して、より長い一時停止を挿入できます。 無効な数字は、エラーとして報告されるのではなく、生成中に無視されます。
感嘆符 (!) は有効な文字です。 この文字は、ダイヤル可能なアドレス
dwDuration
DTMF ディジットのミリ秒単位の継続時間と、パルスと DTMF の桁間間隔の両方。 値 0 は既定値を使用します。
戻り値
要求が成功した場合は 0 を返し、エラーが発生した場合は負のエラー番号を返します。 可能な戻り値は次のとおりです。
LINEERR_INVALCALLHANDLE、LINEERR_NOTOWNER、LINEERR_INVALCALLSTATE、LINEERR_OPERATIONUNAVAIL、LINEERR_INVALDIGITMODE、LINEERR_OPERATIONFAILED、LINEERR_INVALPOINTER、LINEERR_RESOURCEUNAVAIL、LINEERR_NOMEM、LINEERR_UNINITIALIZED。
備考
lineGenerateDigits 関数は、すべての数字が生成されたときではなく、桁の生成が正常に開始されたときに正常に完了したと見なされます。
lpszDigits
呼び出しの所有者であるすべてのアプリケーションで、呼び出しごとに進行中のインバンド生成要求 (トーン生成またはディジット生成) は 1 つだけです。 呼び出しのディジット生成は、別のディジット生成要求またはトーン生成要求を開始することによって取り消されます。 現在の桁の生成を取り消すために、アプリケーションは lineGenerateDigits を呼び出し、lpszDigits パラメーター NULL を指定できます。
サービス プロバイダーとハードウェアに応じて、アプリケーションは自身が生成する数字を監視できます。 これが望ましくない場合、アプリケーションは数字の生成中に数字の監視を無効にすることができます。
手記
tapi.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして lineGenerateDigits を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| ターゲット プラットフォーム の |
ウィンドウズ |
| ヘッダー | tapi.h |
| ライブラリ | Tapi32.lib |
| DLL | Tapi32.dll |
関連項目
lineDial を
lineGenerateTone を