tapi.h) 的 LINECALLSTATUS 結構 (
LINECALLSTATUS 結構描述呼叫的目前狀態。 此結構中的資訊取決於位址的裝置功能、叫用應用程式的呼叫擁有權，以及正在查詢之呼叫的目前狀態。 lineGetCallStatus 和 TSPI_lineGetCallStatus 函式會傳回 LINECALLSTATUS 結構。
語法
typedef struct linecallstatus_tag {
DWORD dwTotalSize;
DWORD dwNeededSize;
DWORD dwUsedSize;
DWORD dwCallState;
DWORD dwCallStateMode;
DWORD dwCallPrivilege;
DWORD dwCallFeatures;
DWORD dwDevSpecificSize;
DWORD dwDevSpecificOffset;
DWORD dwCallFeatures2;
#if ...
SYSTEMTIME tStateEntryTime;
#else
WORD tStateEntryTime[8];
#endif
} LINECALLSTATUS, *LPLINECALLSTATUS;
成員
dwTotalSize
配置給這個數據結構的大小總計，以位元組為單位。
dwNeededSize
此數據結構的大小，需要以位元組為單位來保存所有傳回的資訊。
dwUsedSize
包含實用資訊的這個數據結構部分大小，以位元組為單位。
dwCallState
使用其中一個 LINECALLSTATE_常數的呼叫目前呼叫狀態。
dwCallStateMode
dwCallStateMode 成員的解譯與呼叫狀態相關。 在許多情況下，此值會是零。 下表顯示指定 dwCallState 值的 dwCallStateMode 類型。
| dwCallState | 意義 |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
dwCallPrivilege
此呼叫的應用程式許可權。 這個成員會使用一或多個 LINECALLPRIVILEGE_常數。
dwCallFeatures
旗標，指出可在呼叫上叫用的電話語音 API 函式，指定裝置功能的可用性、目前的呼叫狀態，以及叫用應用程式的呼叫擁有權。 零表示應用程式無法在其目前狀態的呼叫上叫用對應的功能;一個表示可以叫用功能。 這個成員會使用 LINECALLFEATURE_常數。
dwDevSpecificSize
裝置特定欄位的大小，以位元組為單位。
dwDevSpecificOffset
從結構的開頭到可變大小的裝置特定欄位的位移。 欄位的大小是由 dwDevSpecificOffset 所指定。
dwCallFeatures2
指出可以在呼叫上叫用其他函式，因為裝置功能、目前的呼叫狀態，以及叫用應用程式的呼叫擁有權等功能的可用性。 dwCallFeatures 成員的延伸。 此成員會使用 LINECALLFEATURE2_常數。
tStateEntryTime
輸入目前呼叫狀態的國際標準時間。
tStateEntryTime[8]
輸入目前呼叫狀態的國際標準時間。
備註
裝置特定的擴充功能應該使用DevSpecific (dwDevSpecificSize 和 dwDevSpecificOffset) 此數據結構的可變大小區域。
每當呼叫的呼叫狀態變更時，應用程式就會傳送 LINE_CALLSTATE 訊息。 此訊息只會提供呼叫的新呼叫狀態。 lineGetCallStatus 提供關於通話的其他狀態。
dwCallFeatures2 和 tStateEntryTime 成員僅適用於開啟 API 版本為 2.0 或更新版本的行裝置的應用程式。
規格需求
| 需求 | 值 |
|---|---|
| 標頭 | tapi.h |