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]

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

需求

另請參閱

數據機DEVCAPS