數據機DEVCAPS結構 (mcx.h)

發行項
03/05/2024

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

語法

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

共用方式為