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

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

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 メンバーは、ローカル モデムでサポートされるモデム オプションを指定します。 モデム・オプションのリストについては、 MODEMDEVCAPS 構造体の説明を参照してください。

dwNegotiatedModemOptions

実際に有効なモデム オプション。 このメンバーは、接続が確立され、ローカル モデムとリモート モデムがモデム オプションをネゴシエートした後に入力されます。

MODEMDEVCAPS 構造体の dwModemOptions メンバーは、ローカル モデムでサポートされるモデム オプションを指定します。 モデム・オプションのリストについては、 MODEMDEVCAPS 構造体の説明を参照してください。

dwNegotiatedDCERate

有効な DCE レート。 このメンバーは、接続が確立され、ローカルモデムとリモートモデムがモデム変調をネゴシエートした後に入力されます。

abVariablePortion[1]

オプションのプロバイダー定義情報。

要件

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

関連項目

MODEMDEVCAPS