MODEMSETTINGS 結構 (mcx.h)
包含數據機組態的相關資訊。
語法
typedef struct _MODEMSETTINGS {
DWORD dwActualSize;
DWORD dwRequiredSize;
DWORD dwDevSpecificOffset;
DWORD dwDevSpecificSize;
DWORD dwCallSetupFailTimer;
DWORD dwInactivityTimeout;
DWORD dwSpeakerVolume;
DWORD dwSpeakerMode;
DWORD dwPreferredModemOptions;
DWORD dwNegotiatedModemOptions;
DWORD dwNegotiatedDCERate;
BYTE abVariablePortion[1];
} MODEMSETTINGS, *PMODEMSETTINGS, *LPMODEMSETTINGS;
成員
dwActualSize
實際傳回給應用程式的資料大小，以位元組為單位。 如果應用程式未為結構的可變長度部分配置足夠的空間，此成員可能小於 dwRequiredSize 成員。
dwRequiredSize
整個 數據機DEVCAPS 結構所需的位元組數目，包括可變長度部分。
dwDevSpecificOffset
結構之提供者定義部分的位移，以位元組為單位，相對於結構的開頭。
dwDevSpecificSize
結構之提供者定義部分的大小，以位元組為單位。
dwCallSetupFailTimer
數據機在撥號完成後應該等候的最大秒數，表示已建立數據機對數據機連線。 如果未在此間隔中建立連線，則會假設呼叫失敗。 此成員相當於在與 Hayes® 相容的數據機中註冊 S7。
dwInactivityTimeout
建立連線之後允許的無活動秒數上限。 如果這段期間內未傳輸或接收任何資料，則會自動結束通話。 如果應用程式意外鎖定或使用者離開，此逾時是用來避免過多的長距離費用或線上服務費用。
dwSpeakerVolume
當喇叭開啟時，監視器喇叭的音量層級。 這個成員可以是下列其中一個值。
| 值 | 意義 |
|---|---|
|
大量。 |
|
低音量。 |
|
中型磁片區。 |
MODEMDEVCAPS結構會指定數據機支援的喇叭磁片區。 實際磁片區是硬體特定的。
dwSpeakerMode
說話者模式。 這個成員可以是下列其中一個值。
| 值 | 意義 |
|---|---|
|
喇叭會開啟，直到建立連線為止。 |
|
喇叭會開啟，直到連線建立為止，不同之處在于它已關閉，而數據機實際上是撥號。 |
|
說話者一律關閉。 |
|
說話者一律開啟。 |
dwPreferredModemOptions
應用程式所要求的數據機選項。 本機和遠端數據機會在通話設定期間交涉數據機選項;這個成員會指定本機數據機的初始交涉位置。
MODEMDEVCAPS結構的dwModemOptions成員會指定本機數據機支援的數據機選項。 如需數據機選項的清單，請參閱 數據機DEVCAPS 結構的描述。
dwNegotiatedModemOptions
實際生效的數據機選項。 建立連線之後，會填入此成員，而本機和遠端數據機會交涉數據機選項。
MODEMDEVCAPS結構的dwModemOptions成員會指定本機數據機支援的數據機選項。 如需數據機選項的清單，請參閱 數據機DEVCAPS 結構的描述。
dwNegotiatedDCERate
有效 DCE 速率。 建立連線之後，即會填入此成員，而本機和遠端數據機會交涉數據機供應器。
abVariablePortion[1]
選擇性提供者定義的資訊。
需求
| 最低支援的用戶端 | Windows XP |
| 最低支援的伺服器 | Windows Server 2003 |
| 標頭 | mcx.h (包含 Windows.h) |