共用方式為


數據機DEVCAPS結構 (mcx.h)

包含數據機功能的相關信息。

語法

typedef struct _MODEMDEVCAPS {
  DWORD dwActualSize;
  DWORD dwRequiredSize;
  DWORD dwDevSpecificOffset;
  DWORD dwDevSpecificSize;
  DWORD dwModemProviderVersion;
  DWORD dwModemManufacturerOffset;
  DWORD dwModemManufacturerSize;
  DWORD dwModemModelOffset;
  DWORD dwModemModelSize;
  DWORD dwModemVersionOffset;
  DWORD dwModemVersionSize;
  DWORD dwDialOptions;
  DWORD dwCallSetupFailTimer;
  DWORD dwInactivityTimeout;
  DWORD dwSpeakerVolume;
  DWORD dwSpeakerMode;
  DWORD dwModemOptions;
  DWORD dwMaxDTERate;
  DWORD dwMaxDCERate;
  BYTE  abVariablePortion[1];
} MODEMDEVCAPS, *PMODEMDEVCAPS, *LPMODEMDEVCAPS;

成員

dwActualSize

實際傳回給應用程式的數據大小,以位元組為單位。 如果應用程式未為結構的可變長度部分配置足夠的空間,此成員可能小於 dwRequiredSize 成員。

dwRequiredSize

整個 數據機DEVCAPS 結構所需的位元組數目,包括可變長度部分。

dwDevSpecificOffset

結構之提供者定義部分的位移,以位元組為單位,相對於結構的開頭。

dwDevSpecificSize

結構之提供者定義部分的大小,以位元組為單位。

dwModemProviderVersion

服務提供者的版本。 此成員的格式和使用取決於服務提供者。

dwModemManufacturerOffset

包含數據機製造商名稱的文字字串位移,以位元組為單位,相對於結構的開頭。

dwModemManufacturerSize

數據機製造商名稱的長度,以位元組為單位。 字串不是以 Null 結尾。

dwModemModelOffset

包含數據機模型的文字字串位移,以位元組為單位,相對於結構的開頭。

dwModemModelSize

模型名稱的長度,以位元組為單位。 字串不是以 Null 結尾。

dwModemVersionOffset

如果提供者可以判斷資訊,則為附加數據機的版本和修訂提供文字字串的位移。 位移是以相對於 結構開頭的位元組來指定。

dwModemVersionSize

數據機版本字串的長度,以位元組為單位。 字串不是以 Null 結尾。

dwDialOptions

數據機裝置支援的撥號選項。 這個成員可以是下列值的零或多個。

意義
DIALOPTION_BILLING
0x00000040
數據機支援等候計費音調 (bong) 。
DIALOPTION_DIALTONE
0x00000100
數據機支援等候撥號音。
DIALOPTION_QUIET
0x00000080
數據機支援等候無聲。

dwCallSetupFailTimer

數據機支援的通話設定逾時上限,以秒為單位。 這是可為 數據機SETTINGS 結構之對應成員指定的最大值。

dwInactivityTimeout

數據機所支援的最大非活動逾時,以十分之一秒為單位。 這是可為 數據機SETTINGS 結構之對應成員指定的最大值。

dwSpeakerVolume

數據機支援的喇叭音量設定。 這個成員可以是下列值的零或多個。

意義
MDMVOLFLAG_HIGH
0x00000004
數據機支援高 (MDMVOL_HIGH) 磁碟區。
MDMVOLFLAG_LOW
0x00000001
數據機支援低 (MDMVOL_LOW) 磁碟區。
MDMVOLFLAG_MEDIUM
0x00000002
數據機支援中型 (MDMVOL_MEDIUM) 磁碟區。

dwSpeakerMode

數據機支援的喇叭模式設定。 這個成員可以是下列值的零或多個。

意義
MDMSPKRFLAG_CALLSETUP
0x00000008
數據機支援MDMSPKR_CALLSETUP喇叭模式。
MDMSPKRFLAG_DIAL
0x00000002
數據機支援MDMSPKR_DIAL喇叭模式。
MDMSPKRFLAG_OFF
0x00000001
數據機支援MDMSPKR_OFF喇叭模式。
MDMSPKRFLAG_ON
0x00000004
數據機支援MDMSPKR_ON喇叭模式。

dwModemOptions

數據機選項。 這個成員可以是下列值的零或多個。

MDM_BLIND_DIAL (0x00000200)

MDM_CCITT_OVERRIDE (0x00000040)

MDM_CELLULAR (0x00000008)

MDM_COMPRESSION (0x00000001)

MDM_DIAGNOSTICS (0x000000800)

MDM_ERROR_CONTROL (0x00000002)

MDM_FLOWCONTROL_HARD (0x00000010)

MDM_FLOWCONTROL_SOFT (0x00000020)

MDM_FORCED_EC (0x00000004)

MDM_SPEED_ADJUST (0x00000080)

MDM_TONE_DIAL (0x00000100)

MDM_V23_OVERRIDE (0x00000400)

數據機DEVCAPS 用來設定數據機選項作為 數據機選項作為數據機SETTINGS 結構的一部分時,這些值會如下所示使用。

意義
MDM_CCITT_OVERRIDE
0x00000040
設定時,會針對 V.21 和 V.22 或 V.23 啟用 CCITT 調節。

清除時,會啟用 103 和 212A 的鈴鐺。

MDM_V23_OVERRIDE
0x00000400
設定時,V.23 會啟用CCITT調節。

清除時,V.21 和 V.22 會啟用 CCITT 調節。

 

若要設定 V.23,必須同時設定MDM_CCITT_OVERRIDE和MDM_V23_OVERRIDE。

dwMaxDTERate

每秒位的最大 DTE 速率。

dwMaxDCERate

每秒以位為單位的最大 DCE 速率。

abVariablePortion[1]

可變長度資訊,包括字串和任何提供者定義的資訊。

規格需求

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

另請參閱

MODEMSETTINGS