다음을 통해 공유

capability 명령

  • 아티클

기능 명령은 디바이스의 특정 기능에 대한 정보를 요청합니다. 모든 MCI 디바이스는 이 명령을 인식합니다.

이 명령을 보내려면 다음과 같이 lpszCommand 매개 변수가 설정된 mciSendString 함수를 호출합니다.

_stprintf_s(
  lpszCommand, 
  TEXT("capability %s %s %s"), 
  lpszDeviceID, 
  lpszRequest, 
  lpszFlags
);

매개 변수

lpszDeviceID

MCI 디바이스의 식별자입니다. 이 식별자 또는 별칭은 디바이스를 열 때 할당됩니다.

lpszRequest

디바이스 기능을 식별하는 플래그입니다. 다음 표에서는 기능 명령과 각 형식에서 사용하는 플래그를 인식하는 디바이스 유형을 나열합니다.

값 형식 유형
cdaudio
  • 을(를) 배출할 수 있습니다.
  • 재생할 수 있습니다.
  • 를 기록할 수 있습니다.
  • 저장할 수 있습니다.
  • 복합 디바이스
  • 디바이스 유형(device type)
  • 오디오가 있습니다.
  • 동영상이 있습니다.
  • 파일 사용
digitalvideo
  • 을(를) 배출할 수 있습니다.
  • 고정 가능
  • 을 잠글 수 있습니다.
  • 재생할 수 있습니다.
  • 를 기록할 수 있습니다.
  • 반전할 수 있습니다.
  • 저장할 수 있습니다.
  • 늘일 수 있습니다.
  • 늘일 수 있는 입력
  • 테스트할 수 있습니다.
  • 복합 디바이스
  • 디바이스 유형(device type)
  • 오디오가 있습니다.
  • 가 여전히 있음
  • 동영상이 있습니다.
  • 최대 재생 속도
  • 최소 플레이 속도
  • 파일 사용
  • 색상표를 사용합니다.
  • Windows
오버레이
  • 을(를) 배출할 수 있습니다.
  • 고정 가능
  • 재생할 수 있습니다.
  • 를 기록할 수 있습니다.
  • 저장할 수 있습니다.
  • 늘일 수 있습니다.
  • 복합 디바이스
  • 디바이스 유형(device type)
  • 오디오가 있습니다.
  • 동영상이 있습니다.
  • 파일 사용
  • Windows
sequencer
  • 을(를) 배출할 수 있습니다.
  • 재생할 수 있습니다.
  • 를 기록할 수 있습니다.
  • 저장할 수 있습니다.
  • 복합 디바이스
  • 디바이스 유형(device type)
  • 오디오가 있습니다.
  • 동영상이 있습니다.
  • 파일 사용
Vcr
  • 는 길이를 검색할 수 있습니다.
  • 을(를) 배출할 수 있습니다.
  • 고정 가능
  • 원본을 모니터링할 수 있습니다.
  • 재생할 수 있습니다.
  • 미리 등록할 수 있습니다.
  • 미리 보기 가능
  • 를 기록할 수 있습니다.
  • 반전할 수 있습니다.
  • 저장할 수 있습니다.
  • 테스트할 수 있습니다.
  • 클록 증가율
  • 복합 디바이스
  • 디바이스 유형(device type)
  • 오디오가 있습니다.
  • 에는 클록이 있습니다.
  • 에는 시간 코드가 있습니다.
  • 동영상이 있습니다.
  • 표시 수
  • 검색 정확도
  • 파일 사용
videodisc
  • 을(를) 배출할 수 있습니다.
  • 재생할 수 있습니다.
  • 를 기록할 수 있습니다.
  • 반전할 수 있습니다.
  • 저장할 수 있습니다.
  • Cav
  • Clv
  • 복합 디바이스
  • 디바이스 유형(device type)
  • 빠른 플레이 속도
  • 오디오가 있습니다.
  • 동영상이 있습니다.
  • 일반 플레이 속도
  • 느린 플레이 속도
  • 파일 사용
waveaudio
  • 을(를) 배출할 수 있습니다.
  • 재생할 수 있습니다.
  • 를 기록할 수 있습니다.
  • 저장할 수 있습니다.
  • 복합 디바이스
  • 디바이스 유형(device type)
  • 오디오가 있습니다.
  • 동영상이 있습니다.
  • 입력
  • outputs
  • 파일 사용

다음 표에서는 lpszRequest 매개 변수에 지정할 수 있는 플래그와 해당 의미를 나열합니다.

플래그 의미
는 길이를 검색할 수 있습니다. 디바이스가 미디어 길이를 검색할 수 있으면 TRUE 를 반환합니다.
을(를) 배출할 수 있습니다. 디바이스가 미디어를 배출할 수 있으면 TRUE 를 반환합니다.
고정 가능 디바이스가 프레임 버퍼에서 데이터를 고정할 수 있으면 TRUE 를 반환합니다.
을 잠글 수 있습니다. 디바이스가 데이터를 잠글 수 있으면 TRUE 를 반환합니다.
원본을 모니터링할 수 있습니다. 디바이스가 현재 입력 선택과 관계없이 모니터링되는 출력에 입력(원본)을 전달할 수 있으면 TRUE 를 반환합니다.
재생할 수 있습니다. 디바이스가 재생할 수 있는 경우 TRUE 를 반환합니다.
미리 등록할 수 있습니다. 디바이스가 큐 명령을 사용하여 "preroll" 플래그를 지원하는 경우 TRUE를 반환합니다.
미리 보기 가능 디바이스에서 미리 보기를 지원하는 경우 TRUE 를 반환합니다.
를 기록할 수 있습니다. 디바이스에서 녹음/녹화를 지원하는 경우 TRUE 를 반환합니다.
반전할 수 있습니다. 디바이스가 역방향으로 재생할 수 있으면 TRUE 를 반환합니다.
저장할 수 있습니다. 디바이스에서 데이터를 저장할 수 있으면 TRUE 를 반환합니다.
늘일 수 있습니다. 디바이스가 프레임을 확장하여 지정된 디스플레이 사각형을 채울 수 있으면 TRUE 를 반환합니다.
늘일 수 있는 입력 디바이스가 프레임 버퍼로 이미지를 디지털화하는 과정에서 이미지의 크기를 조정할 수 있으면 TRUE 를 반환합니다.
테스트할 수 있습니다. 디바이스가 테스트 키워드(keyword) 인식하는 경우 TRUE를 반환합니다.
Cav 다른 항목과 결합된 경우 이 플래그는 반환 정보가 CAV 형식 비디오 디스크에 적용되도록 지정합니다. videodisc가 삽입되지 않은 경우 기본값입니다.
클록 증가율 외부 클록이 초당 지원하는 세분화 수를 반환합니다. 외부 클록이 밀리초 클록인 경우 반환 값은 1000입니다. 반환 값이 0이면 클록이 지원되지 않습니다.
clv 다른 항목과 결합된 경우 이 플래그는 반환 정보가 CLV 형식 비디오 디스크에 적용되도록 지정합니다.
복합 디바이스 디바이스가 요소 이름(파일 이름)을 지원하는 경우 TRUE 를 반환합니다.
디바이스 유형(device type) 다음 중 하나일 수 있는 디바이스 유형 이름을 반환합니다.
  • cdaudio
  • dat
  • digitalvideo
  • other
  • 오버레이
  • 스캐너
  • sequencer
  • Vcr
  • videodisc
  • waveaudio
빠른 플레이 속도 초당 프레임 단위로 빠른 재생 속도를 반환하거나 디바이스가 빠르게 재생할 수 없는 경우 0을 반환합니다.
오디오가 있습니다. 디바이스에서 오디오 재생을 지원하는 경우 TRUE 를 반환합니다.
에는 클록이 있습니다. 디바이스에 시계가 있는 경우 TRUE 를 반환합니다.
가 여전히 있음 디바이스가 단일 이미지로 파일을 동작 비디오 파일보다 더 효율적으로 처리하면 TRUE 를 반환합니다.
에는 시간 코드가 있습니다. 디바이스에서 시간 코드를 지원할 수 있거나 알 수 없는 경우 TRUE 를 반환합니다.
동영상이 있습니다. 디바이스에서 비디오를 지원하는 경우 TRUE 를 반환합니다.
입력 입력 디바이스의 총 수를 반환합니다.
최대 재생 속도 디바이스의 최대 재생 속도를 초당 프레임 단위로 반환합니다.
최소 플레이 속도 디바이스의 최소 재생 속도를 초당 프레임 단위로 반환합니다.
일반 플레이 속도 디바이스의 기본 재생 속도를 초당 프레임 단위로 반환합니다.
표시 수 사용할 수 있는 최대 표시 수를 반환합니다. 0은 표시가 지원되지 않음을 나타냅니다.
outputs 출력 디바이스의 총 수를 반환합니다.
검색 정확도 프레임에서 검색의 예상 정확도를 반환합니다. 0은 디바이스가 프레임 정확함을 나타내고, 1은 디바이스가 표시된 검색 위치의 한 프레임 내에 있어야 함을 나타냅니다.
느린 플레이 속도 초당 프레임의 느린 재생 속도를 반환하거나 디바이스가 느리게 재생할 수 없는 경우 0을 반환합니다.
파일 사용 복합 디바이스에서 사용하는 데이터 스토리지가 파일인 경우 TRUE 를 반환합니다.
색상표를 사용합니다. 디바이스에서 팔레트를 사용하는 경우 TRUE 를 반환합니다.
Windows 디바이스에서 지원할 수 있는 동시 디스플레이 창 수를 반환합니다.

lpszFlags

"wait", "notify" 또는 둘 다일 수 있습니다. 디지털 비디오 및 VCR 디바이스의 경우 "테스트"를 지정할 수도 있습니다. 이러한 플래그에 대한 자세한 내용은 대기, 알림 및 테스트 플래그를 참조하세요.

반환 값

mciSendString 함수의 lpszReturnString 매개 변수에 정보를 반환합니다. 정보는 요청 유형에 따라 달라집니다.

예제

다음 명령은 "mysound" 디바이스의 디바이스 유형을 반환합니다.

capability mysound device type

요구 사항

요구 사항 값
지원되는 최소 클라이언트
 Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버
 Windows 2000 Server[데스크톱 앱만]

추가 정보

Mci

MCI 명령 문자열

큐