MODEMSETTINGS-Struktur (mcx.h)

Artikel
08/24/2023

Enthält Informationen zur Konfiguration eines Modems.

Syntax

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;

Members

dwActualSize

Die Größe der tatsächlich an die Anwendung zurückgegebenen Daten in Bytes. Dieser Member kann kleiner als der dwRequiredSize-Member sein, wenn eine Anwendung nicht genügend Speicherplatz für den Teil der Struktur mit variabler Länge zugewiesen hat.

dwRequiredSize

Die Anzahl der Bytes, die für die gesamte MODEMDEVCAPS-Struktur erforderlich sind, einschließlich des Teils mit variabler Länge.

dwDevSpecificOffset

Der Offset des vom Anbieter definierten Teils der Struktur in Bytes relativ zum Anfang der Struktur.

dwDevSpecificSize

Die Größe des vom Anbieter definierten Teils der Struktur in Bytes.

dwCallSetupFailTimer

Die maximale Anzahl von Sekunden, die das Modem nach Abschluss der Einwahl warten soll, um einen Hinweis darauf zu erhalten, dass eine Modem-zu-Modem-Verbindung hergestellt wurde. Wenn in diesem Intervall keine Verbindung hergestellt wird, wird angenommen, dass der Aufruf fehlgeschlagen ist. Dieser Member entspricht der Registrierung von S7 in Hayes-kompatiblen® Modems.

dwInactivityTimeout

Die maximale Anzahl von Sekunden der Inaktivität, die nach dem Herstellen einer Verbindung zulässig ist. Wenn für diesen Zeitraum keine Daten übertragen oder empfangen werden, wird der Anruf automatisch beendet. Dieses Timeout wird verwendet, um übermäßige Fernverkehrsgebühren oder Online-Dienstgebühren zu vermeiden, wenn eine Anwendung unerwartet gesperrt wird oder der Benutzer verlässt.

dwSpeakerVolume

Die Lautstärke des Monitorlautsprechers, wenn der Lautsprecher eingeschaltet ist. Dieser Member kann einer der folgenden Werte sein.

Wert	Bedeutung
MDMVOL_HIGH 0x00000002	Hohe Lautstärke.
MDMVOL_LOW 0x00000000	Geringes Volumen.
MDMVOL_MEDIUM 0x00000001	Mittleres Volumen.

Die MODEMDEVCAPS-Struktur gibt die Lautsprechervolumes an, die ein Modem unterstützt. Tatsächliche Volumes sind hardwarespezifisch.

dwSpeakerMode

Der Lautsprechermodus. Dieser Member kann einer der folgenden Werte sein.

Wert	Bedeutung
MDMSPKR_CALLSETUP 0x00000008	Der Lautsprecher ist aktiviert, bis eine Verbindung hergestellt wird.
MDMSPKR_DIAL 0x00000002	Der Lautsprecher ist eingeschaltet, bis eine Verbindung hergestellt wird, mit der Ausnahme, dass er ausgeschaltet ist, während das Modem tatsächlich wählt.
MDMSPKR_OFF 0x00000001	Der Lautsprecher ist immer ausgeschaltet.
MDMSPKR_ON 0x00000004	Der Lautsprecher ist immer eingeschaltet.

dwPreferredModemOptions

Die von der Anwendung angeforderten Modemoptionen. Das lokale Modem und das Remotemodem verhandeln die Modemoptionen während der Einrichtung des Anrufs. Dieser Member gibt die anfängliche Verhandlungsposition des lokalen Modems an.

Der dwModemOptions-Member der MODEMDEVCAPS-Struktur gibt die vom lokalen Modem unterstützten Modemoptionen an. Eine Liste der Modemoptionen finden Sie in der Beschreibung der MODEMDEVCAPS-Struktur .

dwNegotiatedModemOptions

Die Modemoptionen, die tatsächlich in Kraft sind. Dieser Member wird ausgefüllt, nachdem eine Verbindung hergestellt wurde und die modems lokal und remote modems modems die Modemoptionen aushandeln.

dwNegotiatedDCERate

Die DCE-Rate, die wirksam ist. Dieser Member wird ausgefüllt, nachdem eine Verbindung hergestellt wurde und die lokalen und Remotemodems Modemmodulationen aushandeln.

abVariablePortion[1]

Optionale vom Anbieter definierte Informationen.

Anforderungen


Unterstützte Mindestversion (Client)	Windows XP
Unterstützte Mindestversion (Server)	Windows Server 2003
Kopfzeile	mcx.h (windows.h einschließen)

Weitere Informationen

MODEMDEVCAPS