MODEMDEVCAPS 구조체(mcx.h)

아티클
03/02/2024

모뎀의 기능에 대한 정보를 포함합니다.

구문

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;

멤버

dwActualSize

실제로 애플리케이션에 반환된 데이터의 크기(바이트)입니다. 애플리케이션이 구조체의 가변 길이 부분에 충분한 공간을 할당하지 않은 경우 이 멤버는 dwRequiredSize 멤버보다 작을 수 있습니다.

dwRequiredSize

가변 길이 부분을 포함하여 전체 MODEMDEVCAPS 구조체에 필요한 바이트 수입니다.

dwDevSpecificOffset

구조체의 공급자 정의 부분 오프셋(구조체의 시작 부분을 기준으로 바이트)입니다.

dwDevSpecificSize

구조체의 공급자 정의 부분 크기(바이트)입니다.

dwModemProviderVersion

서비스 공급자의 버전입니다. 이 멤버의 형식 및 사용은 서비스 공급자에 따라 달라집니다.

dwModemManufacturerOffset

구조체의 시작 부분을 기준으로 모뎀 제조업체의 이름을 포함하는 텍스트 문자열의 오프셋(바이트)입니다.

dwModemManufacturerSize

모뎀 제조업체 이름의 길이(바이트)입니다. 문자열이 null로 종료되지 않습니다.

dwModemModelOffset

구조체의 시작 부분을 기준으로 모뎀의 모델을 포함하는 텍스트 문자열의 오프셋(바이트)입니다.

dwModemModelSize

모델 이름의 길이(바이트)입니다. 문자열이 null로 종료되지 않습니다.

dwModemVersionOffset

공급자가 정보를 확인할 수 있는 경우 연결된 모뎀의 버전 및 수정 버전을 제공하는 텍스트 문자열의 오프셋입니다. 오프셋은 구조체의 시작 부분을 기준으로 바이트로 지정됩니다.

dwModemVersionSize

모뎀 버전 문자열의 길이(바이트)입니다. 문자열이 null로 종료되지 않습니다.

dwDialOptions

모뎀 디바이스에서 지원하는 전화 걸기 옵션입니다. 이 멤버는 다음 값 중 0개 이상일 수 있습니다.

값	의미
DIALOPTION_BILLING 0x00000040	모뎀은 청구 톤(봉) 대기를 지원합니다.
DIALOPTION_DIALTONE 0x00000100	모뎀은 다이얼 톤 대기를 지원합니다.
DIALOPTION_QUIET 0x00000080	모뎀은 자동 대기를 지원합니다.

dwCallSetupFailTimer

모뎀에서 지원하는 최대 호출 설정 시간 제한(초)입니다. 이는 MODEMSETTINGS 구조체의 해당 멤버에 대해 지정할 수 있는 가장 큰 값입니다.

dwInactivityTimeout

모뎀에서 지원하는 최대 비활성 시간 제한(초의 10분의 1)입니다. 이는 MODEMSETTINGS 구조체의 해당 멤버에 대해 지정할 수 있는 가장 큰 값입니다.

dwSpeakerVolume

모뎀에서 지원하는 스피커 볼륨 설정입니다. 이 멤버는 다음 값 중 0개 이상일 수 있습니다.

값	의미
MDMVOLFLAG_HIGH 0x00000004	모뎀은 높은(MDMVOL_HIGH) 볼륨을 지원합니다.
MDMVOLFLAG_LOW 0x00000001	모뎀은 낮은(MDMVOL_LOW) 볼륨을 지원합니다.
MDMVOLFLAG_MEDIUM 0x00000002	모뎀은 중간(MDMVOL_MEDIUM) 볼륨을 지원합니다.

dwSpeakerMode

모뎀에서 지원하는 스피커 모드 설정입니다. 이 멤버는 다음 값 중 0개 이상일 수 있습니다.

값	의미
MDMSPKRFLAG_CALLSETUP 0x00000008	모뎀은 MDMSPKR_CALLSETUP 스피커 모드를 지원합니다.
MDMSPKRFLAG_DIAL 0x00000002	모뎀은 MDMSPKR_DIAL 스피커 모드를 지원합니다.
MDMSPKRFLAG_OFF 0x00000001	모뎀은 MDMSPKR_OFF 스피커 모드를 지원합니다.
MDMSPKRFLAG_ON 0x00000004	모뎀은 MDMSPKR_ON 스피커 모드를 지원합니다.

dwModemOptions

모뎀 옵션입니다. 이 멤버는 다음 값 중 0개 이상일 수 있습니다.

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)

MODEMDEVCAPS를 사용하여 모뎀 옵션을 설정하는 경우 MODEMSETTINGS 구조의 일부로 이러한 값이 다음과 같이 사용됩니다.

값	의미
MDM_CCITT_OVERRIDE 0x00000040	설정되면 V.21 및 V.22 또는 V.23에 대해 CCITT 변조가 사용하도록 설정됩니다. 지우면 벨 변조가 103 및 212A에 대해 사용하도록 설정됩니다.
MDM_V23_OVERRIDE 0x00000400	설정되면 V.23에 대해 CCITT 변조가 사용하도록 설정됩니다. 지우면 V.21 및 V.22에 대해 CCITT 변조가 사용하도록 설정됩니다.

V.23을 설정하려면 MDM_CCITT_OVERRIDE 및 MDM_V23_OVERRIDE 모두 설정해야 합니다.

dwMaxDTERate

초당 최대 DTE 속도(비트)입니다.

dwMaxDCERate

초당 최대 DCE 속도(비트)입니다.

abVariablePortion[1]

문자열 및 공급자 정의 정보를 포함한 가변 길이 정보입니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP
지원되는 최소 서버	Windows Server 2003
머리글	mcx.h(Windows.h 포함)

추가 정보

MODEMSETTINGS

다음을 통해 공유