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 |