MODEMDEVCAPS 構造体 (mcx.h)

[アーティクル]
02/28/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

可変長部分を含む MODEMDEVCAPS 構造体全体に必要なバイト数。

dwDevSpecificOffset

構造体のプロバイダー定義部分のオフセット (構造体の先頭を基準にしたバイト単位)。

dwDevSpecificSize

構造体のプロバイダー定義部分のサイズ (バイト単位)。

dwModemProviderVersion

サービスプロバイダーのバージョン。このメンバーの形式と使用方法は、サービスプロバイダーによって異なります。

dwModemManufacturerOffset

モデム製造元の名前を含むテキスト文字列のオフセット (構造体の先頭を基準にしたバイト単位)。

dwModemManufacturerSize

モデムの製造元名の長さ (バイト単位)。文字列は null で終わるものではありません。

dwModemModelOffset

モデムのモデルを含むテキスト文字列のオフセット (構造体の先頭からの相対バイト単位)。

dwModemModelSize

モデル名の長さ (バイト単位)。文字列は null で終わるものではありません。

dwModemVersionOffset

プロバイダーが情報を特定できる場合に、接続されているモデムのバージョンとリビジョンを示すテキスト文字列のオフセット。オフセットは、構造体の先頭を基準にしてバイト単位で指定されます。

dwModemVersionSize

モデムバージョン文字列の長さ (バイト単位)。文字列は null で終わるものではありません。

dwDialOptions

モデムデバイスでサポートされているダイヤルオプション。このメンバーには、次の値の 0 個以上を指定できます。

値	意味
DIALOPTION_BILLING 0x00000040	モデムは、課金トーン (bong) の待機をサポートしています。
DIALOPTION_DIALTONE 0x00000100	モデムはダイヤルトーンの待機をサポートします。
DIALOPTION_QUIET 0x00000080	モデムは、静かな待機をサポートします。

dwCallSetupFailTimer

モデムでサポートされている最大呼び出しセットアップタイムアウト (秒単位)。これは、 MODEMSETTINGS 構造体の対応するメンバーに指定できる最大値です。

dwInactivityTimeout

モデムでサポートされる最大非アクティブタイムアウト (10 分の 1 秒)。これは、 MODEMSETTINGS 構造体の対応するメンバーに指定できる最大値です。

dwSpeakerVolume

モデムでサポートされているスピーカーボリュームの設定。このメンバーには、次の値の 0 個以上を指定できます。

値	意味
MDMVOLFLAG_HIGH 0x00000004	モデムは、高 (MDMVOL_HIGH) ボリュームをサポートします。
MDMVOLFLAG_LOW 0x00000001	モデムは、低 (MDMVOL_LOW) ボリュームをサポートします。
MDMVOLFLAG_MEDIUM 0x00000002	モデムは、中 (MDMVOL_MEDIUM) ボリュームをサポートします。

dwSpeakerMode

モデムでサポートされているスピーカーモードの設定。このメンバーには、次の値の 0 個以上を指定できます。

値	意味
MDMSPKRFLAG_CALLSETUP 0x00000008	モデムは、MDMSPKR_CALLSETUP スピーカーモードをサポートしています。
MDMSPKRFLAG_DIAL 0x00000002	モデムは、MDMSPKR_DIAL スピーカーモードをサポートしています。
MDMSPKRFLAG_OFF 0x00000001	モデムは、MDMSPKR_OFF スピーカーモードをサポートします。
MDMSPKRFLAG_ON 0x00000004	モデムは、MDMSPKR_ONスピーカーモードをサポートしています。

dwModemOptions

モデムオプション。このメンバーには、次の値の 0 個以上を指定できます。

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)

MODEMDEVCAPS を使用してモデム・オプションを設定する場合、MODEMSETTINGS 構造体の一部として、これらの値は以下のように使用されます。

値	意味
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 レート (1 秒あたりのビット数)。

dwMaxDCERate

最大 DCE レート (ビット/秒)。

abVariablePortion[1]

文字列とプロバイダー定義の情報を含む可変長情報。

要件

要件	値
サポートされている最小のクライアント	Windows XP
サポートされている最小のサーバー	Windows Server 2003
Header	mcx.h (Windows.h を含む)

こちらもご覧ください

MODEMSETTINGS

次の方法で共有