MODEMDEVCAPS-Struktur (mcx.h)

Artikel
02/28/2024

Enthält Informationen zu den Funktionen eines Modems.

Syntax

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;

Member

dwActualSize

Die Größe der tatsächlich an die Anwendung zurückgegebenen Daten in Bytes. Dieser Member ist möglicherweise kleiner als der dwRequiredSize-Member , wenn eine Anwendung nicht genügend Platz 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.

dwModemProviderVersion

Die Version des Dienstanbieters. Das Format und die Verwendung dieses Members hängen vom Dienstanbieter ab.

dwModemManufacturerOffset

Der Offset einer Textzeichenfolge, die den Namen des Modemherstellers in Bytes relativ zum Anfang der Struktur enthält.

dwModemManufacturerSize

Die Länge des Modemherstellernamens in Bytes. Die Zeichenfolge ist nicht null-beendet.

dwModemModelOffset

Der Offset einer Textzeichenfolge, die das Modell des Modems enthält, in Bytes relativ zum Anfang der Struktur.

dwModemModelSize

Die Länge des Modellnamens in Bytes. Die Zeichenfolge ist nicht null-beendet.

dwModemVersionOffset

Der Offset einer Textzeichenfolge, die die Version und Revision des angefügten Modems angibt, wenn der Anbieter die Informationen ermitteln konnte. Der Offset wird relativ zum Anfang der Struktur in Bytes angegeben.

dwModemVersionSize

Die Länge der Modemversionszeichenfolge in Bytes. Die Zeichenfolge ist nicht null-beendet.

dwDialOptions

Die vom Modemgerät unterstützten Wähloptionen. Dieser Member kann 0 oder mehr der folgenden Werte sein.

Wert	Bedeutung
DIALOPTION_BILLING 0x00000040	Das Modem unterstützt das Warten auf Abrechnungston (Bong).
DIALOPTION_DIALTONE 0x00000100	Das Modem unterstützt das Warten auf einen Wählton.
DIALOPTION_QUIET 0x00000080	Das Modem unterstützt das Warten auf Ruhe.

dwCallSetupFailTimer

Das maximale vom Modem unterstützte Timeout für die Anrufeinrichtung in Sekunden. Dies ist der größte Wert, der für das entsprechende Element der MODEMSETTINGS-Struktur angegeben werden kann.

dwInactivityTimeout

Das vom Modem unterstützte maximale Inaktivitätstimeout in Zehntelsekunden. Dies ist der größte Wert, der für das entsprechende Element der MODEMSETTINGS-Struktur angegeben werden kann.

dwSpeakerVolume

Die vom Modem unterstützten Lautsprecherlautstärkeeinstellungen. Dieser Member kann 0 oder mehr der folgenden Werte sein.

Wert	Bedeutung
MDMVOLFLAG_HIGH 0x00000004	Das Modem unterstützt hohe (MDMVOL_HIGH) Volumes.
MDMVOLFLAG_LOW 0x00000001	Das Modem unterstützt niedrige Volumes (MDMVOL_LOW).
MDMVOLFLAG_MEDIUM 0x00000002	Das Modem unterstützt ein mittleres Volume (MDMVOL_MEDIUM).

dwSpeakerMode

Die vom Modem unterstützten Lautsprechermoduseinstellungen. Dieser Member kann 0 oder mehr der folgenden Werte sein.

Wert	Bedeutung
MDMSPKRFLAG_CALLSETUP 0x00000008	Das Modem unterstützt den MDMSPKR_CALLSETUP Lautsprechermodus.
MDMSPKRFLAG_DIAL 0x00000002	Das Modem unterstützt den MDMSPKR_DIAL Lautsprechermodus.
MDMSPKRFLAG_OFF 0x00000001	Das Modem unterstützt den MDMSPKR_OFF Lautsprechermodus.
MDMSPKRFLAG_ON 0x00000004	Das Modem unterstützt den MDMSPKR_ON Lautsprechermodus.

dwModemOptions

Die Modemoptionen. Dieser Member kann 0 oder mehr der folgenden Werte sein.

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)

Wenn MODEMDEVCAPS zum Festlegen von Modemoptionen als Teil der MODEMSETTINGS-Struktur verwendet wird, werden diese Werte wie folgt verwendet.

Wert	Bedeutung
MDM_CCITT_OVERRIDE 0x00000040	Wenn festgelegt, werden CCITT-Modulationen für V.21 und V.22 oder V.23 aktiviert. Wenn sie klar sind, werden Glockenmodulationen für 103 und 212A aktiviert.
MDM_V23_OVERRIDE 0x00000400	Wenn festgelegt, werden CCITT-Modulationen für V.23 aktiviert. Wenn sie deaktiviert sind, werden CCITT-Modulationen für V.21 und V.22 aktiviert.

Damit V.23 festgelegt werden kann, müssen sowohl MDM_CCITT_OVERRIDE als auch MDM_V23_OVERRIDE festgelegt werden.

dwMaxDTERate

Die maximale DTE-Rate in Bits pro Sekunde.

dwMaxDCERate

Die maximale DCE-Rate in Bits pro Sekunde.

abVariablePortion[1]

Informationen mit variabler Länge, einschließlich Zeichenfolgen und allen vom Anbieter definierten Informationen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP
Unterstützte Mindestversion (Server)	Windows Server 2003
Kopfzeile	mcx.h (Einschließen von Windows.h)

Weitere Informationen

MODEMSETTINGS

Freigeben über