MODEMSETTINGS-Struktur (mcx.h)

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.

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.

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.

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 .

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

Weitere Informationen

MODEMDEVCAPS