LINEMEDIACONTROTONE 結構 (tapi.h)

  • 發行項

LINEMEDIACONTROTONE 結構描述偵測到音調時要執行的媒體動作。 它會當做陣列中的專案使用。 lineSetMediaControl 和 TSPI_lineSetMediaControl 函式會使用此結構。

語法

typedef struct linemediacontroltone_tag {
  DWORD dwAppSpecific;
  DWORD dwDuration;
  DWORD dwFrequency1;
  DWORD dwFrequency2;
  DWORD dwFrequency3;
  DWORD dwMediaControl;
} LINEMEDIACONTROLTONE, *LPLINEMEDIACONTROLTONE;

成員

dwAppSpecific

應用程式用來標記音調。 偵測到此音調時， dwAppSpecific 成員的值會傳回應用程式。

dwDuration

在進行偵測之前應該顯示音調的時間持續時間，以毫秒為單位。

dwFrequency1

音調的第一個頻率，以 hertz 為單位。

dwFrequency2

音調的第二個頻率，以 hertz 為單位。

dwFrequency3

音調的第三個頻率，以 hertz 為單位。 如果音調中需要少於三個頻率，則值 0 應該用於未使用的頻率。 所有三個頻率都設為零的音調會解譯為無聲，而且可用於無聲偵測。

dwMediaControl

媒體控制動作。 此成員會使用其中一個 LINEMEDIACONTROL_常數。

備註

此結構可能不會延伸。

LINEMEDIACONTROTONE 結構會定義元組<音調、媒體控制動作>。 這些 Tuple 的數位會傳遞至 lineSetMediaControl 函式，以設定由指定呼叫之媒體類型變更所觸發的媒體控件動作。 偵測到已列出的媒體類型變更時，會叫用媒體數據流上的對應動作。

所有頻率都設為零的音調會對應至無聲。 因此，應用程式可以監視呼叫的信息數據流，以取得無聲。

規格需求

需求 值
標頭 tapi.h

另請參閱

TSPI_lineSetMediaControl

lineSetMediaControl