共用方式為


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

當喇叭開啟時,監視器喇叭的音量層級。 這個成員可以是下列其中一個值。

意義
MDMVOL_HIGH
0x00000002
大量。
MDMVOL_LOW
0x00000000
低音量。
MDMVOL_MEDIUM
0x00000001
中型磁片區。
 

MODEMDEVCAPS結構會指定數據機支援的喇叭磁片區。 實際磁片區是硬體特定的。

dwSpeakerMode

說話者模式。 這個成員可以是下列其中一個值。

意義
MDMSPKR_CALLSETUP
0x00000008
喇叭會開啟,直到建立連線為止。
MDMSPKR_DIAL
0x00000002
喇叭會開啟,直到連線建立為止,不同之處在于它已關閉,而數據機實際上是撥號。
MDMSPKR_OFF
0x00000001
說話者一律關閉。
MDMSPKR_ON
0x00000004
說話者一律開啟。

dwPreferredModemOptions

應用程式所要求的數據機選項。 本機和遠端數據機會在通話設定期間交涉數據機選項;這個成員會指定本機數據機的初始交涉位置。

MODEMDEVCAPS結構的dwModemOptions成員會指定本機數據機支援的數據機選項。 如需數據機選項的清單,請參閱 數據機DEVCAPS 結構的描述。

dwNegotiatedModemOptions

實際生效的數據機選項。 建立連線之後,會填入此成員,而本機和遠端數據機會交涉數據機選項。

MODEMDEVCAPS結構的dwModemOptions成員會指定本機數據機支援的數據機選項。 如需數據機選項的清單,請參閱 數據機DEVCAPS 結構的描述。

dwNegotiatedDCERate

有效 DCE 速率。 建立連線之後,即會填入此成員,而本機和遠端數據機會交涉數據機供應器。

abVariablePortion[1]

選擇性提供者定義的資訊。

需求

   
最低支援的用戶端 Windows XP
最低支援的伺服器 Windows Server 2003
標頭 mcx.h (包含 Windows.h)

另請參閱

數據機DEVCAPS