MCI_GETDEVCAPS 명령

MCI_GETDEVCAPS 명령은 디바이스에 대한 정적 정보를 검색합니다. 모든 디바이스는 이 명령을 인식합니다. 이 명령에 사용할 수 있는 매개 변수 및 플래그는 선택한 디바이스에 따라 달라집니다. lpCapsParms로 식별된 구조체의 dwReturn 멤버에 정보가 반환됩니다.

이 명령을 보내려면 다음 매개 변수를 사용하여 mciSendCommand 함수를 호출합니다.

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_GETDEVCAPS, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_GETDEVCAPS_PARMS) lpCapsParms
);

매개 변수

wDeviceID

명령 메시지를 받을 MCI 디바이스의 디바이스 식별자입니다.

dwFlags

디지털 비디오 및 VCR 디바이스의 경우 MCI_NOTIFY, MCI_WAIT 또는 MCI_TEST. 이러한 플래그에 대한 자세한 내용은 대기, 알림 및 테스트 플래그를 참조하세요.

lpCapsParms

MCI_GETDEVCAPS_PARMS 구조체에 대한 포인터입니다.

반환 값

성공하면 0을 반환하고, 그렇지 않으면 오류를 반환합니다.

설명

다음 추가 표준 및 명령별 플래그는 MCI_GETDEVCAPS 지원하는 모든 디바이스에 적용됩니다.

MCI_GETDEVCAPS_COMPOUND_DEVICE

디바이스에서 명시적으로 열고 닫아야 하는 데이터 스토리지를 사용하는 경우 dwReturn 멤버는 TRUE 로 설정됩니다. 그렇지 않으면 FALSE 로 설정됩니다.

MCI_GETDEVCAPS_DEVICE_TYPE

dwReturn 멤버는 MCI 디바이스 유형에 나열된 값 중 하나로 설정됩니다.

MCI_GETDEVCAPS_HAS_AUDIO

디바이스에 오디오 출력이 있는 경우 dwReturn 멤버가 TRUE 로 설정됩니다. 그렇지 않으면 FALSE 로 설정됩니다.

MCI_GETDEVCAPS_HAS_VIDEO

디바이스에 비디오 출력이 있는 경우 dwReturn 멤버가 TRUE 로 설정됩니다. 그렇지 않으면 FALSE 로 설정됩니다. 예를 들어 멤버는 videodisc 명령 집합을 지원하는 디바이스의 경우 TRUE 로 설정됩니다.

MCI_GETDEVCAPS_ITEM

MCI_GETDEVCAPS_PARMS 구조체의 dwItem 멤버에 다음 상수 중 하나가 포함되도록 지정합니다.

MCI_GETDEVCAPS_CAN_EJECT

디바이스가 미디어를 배출할 수 있으면 dwReturn 멤버가 TRUE 로 설정됩니다. 그렇지 않으면 FALSE로 설정됩니다.

MCI_GETDEVCAPS_CAN_PLAY

디바이스가 미디어를 재생할 수 있으면 dwReturn 멤버가 TRUE 로 설정됩니다. 그렇지 않으면 FALSE로 설정됩니다. 디바이스가 TRUE를 지정하면 디바이스가 MCI_PAUSE 및 MCI_STOP 명령과 MCI_PLAY 명령을 지원합니다.

MCI_GETDEVCAPS_CAN_RECORD

디바이스에서 녹음/녹화를 지원하는 경우 dwReturn 멤버가 TRUE 로 설정됩니다. 그렇지 않으면 FALSE로 설정됩니다. 디바이스가 TRUE를 지정하면 디바이스가 MCI_RECORD 명령뿐만 아니라 MCI_PAUSE 및 MCI_STOP 명령을 지원합니다.

MCI_GETDEVCAPS_CAN_SAVE

디바이스가 파일을 저장할 수 있으면 dwReturn 멤버가 TRUE 로 설정됩니다. 그렇지 않으면 FALSE로 설정됩니다.

MCI_GETDEVCAPS_USES_FILES

디바이스에 파일 이름이 필요한 경우 dwReturn 멤버가 TRUE 로 설정됩니다. 그렇지 않으면 FALSE 로 설정됩니다. 복합 디바이스만 파일을 사용합니다.

digitalvideo 디바이스 유형에 대한 MCI_GETDEVCAPS_PARMSdwItem 멤버에 다음 플래그를 지정할 수 있습니다.

MCI_DGV_GETDEVCAPS_CAN_FREEZE

디바이스가 프레임을 고정할 수 있으면 dwReturn 멤버가 TRUE 로 설정됩니다. 그렇지 않으면 FALSE로 설정됩니다.

MCI_DGV_GETDEVCAPS_CAN_LOCK

디바이스가 잠글 수 있으면 dwReturn 멤버가 TRUE 로 설정됩니다. 그렇지 않으면 FALSE로 설정됩니다.

MCI_DGV_GETDEVCAPS_CAN_REVERSE

디바이스가 역방향으로 재생할 수 있으면 dwReturn 멤버가 TRUE 로 설정됩니다. 그렇지 않으면 FALSE로 설정됩니다.

MCI_DGV_GETDEVCAPS_CAN_STR_IN

디바이스가 입력을 확장할 수 있으면 dwReturn 멤버가 TRUE 로 설정됩니다. 그렇지 않으면 FALSE로 설정됩니다.

MCI_DGV_GETDEVCAPS_CAN_STRETCH

디바이스가 이미지를 확장할 수 있으면 dwReturn 멤버가 TRUE 로 설정됩니다. 그렇지 않으면 FALSE로 설정됩니다.

MCI_DGV_GETDEVCAPS_CAN_TEST

디바이스가 테스트를 수행할 수 있으면 dwReturn 멤버가 TRUE 로 설정됩니다. 그렇지 않으면 FALSE로 설정됩니다.

MCI_DGV_GETDEVCAPS_HAS_STILL

디바이스에서 스틸 이미지를 표시할 수 있으면 dwReturn 멤버가 TRUE 로 설정됩니다. 그렇지 않으면 FALSE로 설정됩니다.

MCI_DGV_GETDEVCAPS_MAX_WINDOWS

dwReturn 멤버는 디바이스가 동시에 처리할 수 있는 최대 창 수로 설정됩니다.

MCI_DGV_GETDEVCAPS_MAXIMUM_RATE

dwReturn 멤버는 초당 프레임 단위로 디바이스의 최대 재생 속도로 설정됩니다.

MCI_DGV_GETDEVCAPS_MINIMUM_RATE

dwReturn 멤버는 디바이스의 최소 재생 속도(초당 프레임)로 설정됩니다.

MCI_DGV_GETDEVCAPS_PALETTES

디바이스가 팔레트 핸들을 반환할 수 있으면 dwReturn 멤버가 TRUE 로 설정됩니다. 그렇지 않으면 FALSE로 설정됩니다.

vcr 디바이스 유형에 대한 MCI_GETDEVCAPS_PARMSdwItem 멤버에 다음 플래그를 지정할 수 있습니다.

MCI_GETDEVCAPS_CLOCK_INCREMENT_RATE

dwReturn 멤버는 초당 증분 수로 설정됩니다.

MCI_VCR_GETDEVCAPS_CAN_DETECT_LENGTH

디바이스가 미디어 길이를 검색할 수 있는 경우 dwReturn 멤버는 TRUE 로 설정됩니다. 그렇지 않으면 FALSE로 설정됩니다.

MCI_VCR_GETDEVCAPS_CAN_FREEZE

디바이스가 출력 이미지를 고정할 수 있는 경우 dwReturn 멤버는 TRUE 로 설정됩니다. 그렇지 않으면 FALSE로 설정됩니다.

MCI_VCR_GETDEVCAPS_CAN_MONITOR_SOURCES

디바이스가 원본을 모니터링할 수 있는 경우 dwReturn 멤버가 TRUE 로 설정됩니다. 그렇지 않으면 FALSE로 설정됩니다.

MCI_VCR_GETDEVCAPS_CAN_PREROLL

디바이스가 미리 등록할 수 있는 경우 dwReturn 멤버가 TRUE 로 설정됩니다. 그렇지 않으면 FALSE로 설정됩니다.

MCI_VCR_GETDEVCAPS_CAN_PREVIEW

디바이스에서 미리 볼 수 있는 경우 dwReturn 멤버가 TRUE 로 설정됩니다. 그렇지 않으면 FALSE로 설정됩니다.

MCI_VCR_GETDEVCAPS_CAN_REVERSE

디바이스가 역방향으로 재생할 수 있는 경우 dwReturn 멤버가 TRUE 로 설정됩니다. 그렇지 않으면 FALSE로 설정됩니다.

MCI_VCR_GETDEVCAPS_CAN_TEST

디바이스에서 테스트할 수 있는 경우 dwReturn 멤버가 TRUE 로 설정됩니다. 그렇지 않으면 FALSE로 설정됩니다.

MCI_VCR_GETDEVCAPS_HAS_CLOCK

디바이스가 외부 클록을 지원하는 경우 dwReturn 멤버가 TRUE 로 설정됩니다. 그렇지 않으면 FALSE로 설정됩니다.

MCI_VCR_GETDEVCAPS_HAS_TIMECODE

디바이스에 시간 코드 기능이 있거나 이 기능을 알 수 없는 경우 dwReturn 멤버가 TRUE 로 설정됩니다. 그렇지 않으면 FALSE로 설정됩니다.

MCI_VCR_GETDEVCAPS_NUMBER_OF_MARKS

dwReturn 멤버는 표시 수(99)로 설정됩니다.

MCI_VCR_GETDEVCAPS_SEEK_ACCURACY

dwReturn 멤버는 디바이스의 검색 정확도로 설정됩니다.

오버레이 디바이스 유형에 대한 MCI_GETDEVCAPS_PARMSdwItem 멤버에 다음 플래그를 지정할 수 있습니다.

MCI_OVLY_GETDEVCAPS_CAN_FREEZE

디바이스가 이미지를 고정할 수 있으면 dwReturn 멤버가 TRUE 로 설정됩니다. 그렇지 않으면 FALSE로 설정됩니다.

MCI_OVLY_GETDEVCAPS_CAN_STRETCH

디바이스가 이미지를 확장하여 프레임을 채울 수 있으면 dwReturn 멤버가 TRUE 로 설정됩니다. 그렇지 않으면 FALSE로 설정됩니다.

MCI_OVLY_GETDEVCAPS_MAX_WINDOWS

dwReturn 멤버는 디바이스가 동시에 처리할 수 있는 최대 창 수로 설정됩니다.

videodisc 디바이스 유형에 대한 MCI_GETDEVCAPS_PARMSdwItem 멤버에 다음 플래그를 지정할 수 있습니다.

MCI_VD_GETDEVCAPS_CAN_REVERSE

videodisc 플레이어가 역방향으로 재생할 수 있으면 dwReturn 멤버가 TRUE 로 설정됩니다. 그렇지 않으면 FALSE로 설정됩니다. 일부 플레이어는 CAV 디스크뿐만 아니라 반대로 CLV 디스크를 재생할 수 있습니다.

MCI_VD_GETDEVCAPS_CAV

다른 항목과 결합하면 반환 정보가 CAV 형식 비디오 디스크에 적용되도록 지정합니다. videodisc가 삽입되지 않은 경우 기본값입니다.

MCI_VD_GETDEVCAPS_CLV

다른 항목과 결합하면 반환 정보가 CLV 형식 videodiscs에 적용되도록 지정합니다.

MCI_VD_GETDEVCAPS_FAST_RATE

dwReturn 멤버는 초당 프레임에서 표준 빠른 플레이 속도로 설정됩니다.

MCI_VD_GETDEVCAPS_NORMAL_RATE

dwReturn 멤버는 초당 프레임의 일반 재생 속도로 설정됩니다.

MCI_VD_GETDEVCAPS_SLOW_RATE

dwReturn 멤버는 초당 프레임에서 표준 느린 플레이 속도로 설정됩니다.

waveaudio 디바이스 유형에 대한 MCI_GETDEVCAPS_PARMSdwItem 멤버에 다음 플래그를 지정할 수 있습니다.

MCI_WAVE_GETDEVCAPS_INPUT

dwReturn 멤버는 파형 입력(기록) 디바이스의 총 수로 설정됩니다.

MCI_WAVE_GETDEVCAPS_OUTPUT

dwReturn 멤버는 파형 출력(재생) 디바이스의 총 수로 설정됩니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
헤더	Mmsystem.h(Windows.h 포함)

추가 정보

Mci

MCI 명령