MODEMDEVCAPS-Struktur (mcx.h)
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.
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.
dwSpeakerMode
Die vom Modem unterstützten Lautsprechermoduseinstellungen. Dieser Member kann 0 oder mehr der folgenden Werte sein.
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.
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) |