ITLegacyCallMediaControl2::GenerateCustomTonesByCollection メソッド (tapi3if.h)

GenerateCustomTonesByCollection メソッドは、指定されたカスタムトーンを生成します。

このメソッドは、Visual Basic およびスクリプトアプリケーションを対象としています。 C/C++ アプリケーションでは、代わりに GenerateCustomTones メソッドを使用する必要があります。

構文

HRESULT GenerateCustomTonesByCollection(
  [in] ITCollection2 *pCustomToneCollection,
  [in] long          lDuration
);

[in] pCustomToneCollection

トーンのコンポーネントを表す ITCustomTone インターフェイスポインターのコレクションを含む ITCollection2 インターフェイスへのポインター。コレクションがマルチ周波数トーンの場合は、さまざまなトーンが同時に再生されます。

[in] lDuration

トーンを維持する必要がある期間 (ミリ秒単位)。値 0 は、既定の期間を使用します。

このメソッドは、これらの値のいずれかを返すことができます。

リターンコード	説明
S_OK	メソッドが成功しました。
E_POINTER	pCustomToneCollection パラメーターが有効なポインターではありません。
E_OUTOFMEMORY	トーンバッファーを割り当てるのに十分なメモリがありません。
TAPI_E_INVALCALLSTATE	呼び出しは接続状態である必要があります。

このメソッドは TAPI 2 の呼び出しに変換されます。xlineGenerateTone 関数。

トーン生成が完了すると、TE_GENERATEEVENT型のイベントが生成されます。