list 명령

  • 아티클

list 명령은 비디오 및 오디오 입력의 수와 유형을 결정합니다. 디지털 비디오 및 VCR 디바이스는 이 명령을 인식합니다.

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

_stprintf_s(
  lpszCommand, 
  TEXT("list %s %s %s"), 
  lpszDeviceID, 
  lpszList, 
  lpszFlags
);

매개 변수

lpszDeviceID

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

lpszList

비디오 및 오디오 입력의 수와 유형을 식별하는 플래그입니다. 다음 표에는 목록 명령과 각 형식에서 사용하는 플래그를 인식하는 디바이스 유형이 나열 되어 있습니다.

값 의미 의미
digitalvideo 오디오 알고리즘audio 품질 알고리즘 알고리즘오디오 streamcountnumber 인덱스 still algorithmstill quality algorithm algorithmvideo algorithmvideo quality algorithmalgorithm video sourcevideo stream
Vcr 오디오 원본 countaudio 원본 번호 인덱스 비디오 원본 countvideo 원본 번호 인덱스

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

값 의미
오디오 알고리즘 명령이 오디오 알고리즘 이름을 검색해야 을 지정합니다.
오디오 품질 알고리즘 알고리즘 지정된 알고리즘과 연결된 품질 수준을 검색해야 하는 명령을 지정합니다. 알고리즘이 "현재"이면 현재 알고리즘의 품질 수준이 반환됩니다.
오디오 원본 수 총 오디오 입력 수를 반환합니다.
오디오 원본 번호 인덱스 원본 인덱스의 오디오 입력 유형을 반환합니다.
오디오 스트림 명령이 작업 영역과 연결된 오디오 스트림의 이름을 검색해야 한다고 지정합니다. 이러한 문자열(예: "영어" 또는 "독일어")은 파일에 포함되고 스트림을 식별합니다.
개수 지정된 형식의 옵션 수를 반환합니다.
숫자 인덱스 지정된 옵션 형식의 특정 옵션( 인덱스로 식별됨)을 설명하는 문자열을 반환합니다. 인덱스 는 1과 "count"에서 반환된 값 사이의 정수여야 합니다.
still 알고리즘 명령이 스틸 알고리즘 이름을 검색해야 한다고 지정합니다.
여전히 품질 알고리즘 알고리즘 지정한 스틸 알고리즘과 연결된 품질 수준을 검색해야 하는 명령을 지정합니다. 알고리즘이 "현재"이면 현재 알고리즘의 품질 수준이 반환됩니다.
비디오 알고리즘 명령이 비디오 알고리즘 이름을 검색해야 한다고 지정합니다.
비디오 품질 알고리즘 알고리즘 지정된 비디오 알고리즘과 연결된 품질 수준을 검색해야 하는 명령을 지정합니다. 알고리즘이 "현재"이면 현재 알고리즘의 품질 수준이 반환됩니다.
비디오 원본 명령이 비디오 원본에 대한 정보를 반환해야 을 지정합니다. "count" 플래그와 함께 사용하면 비디오 원본 수를 반환합니다. "number" 플래그와 함께 사용하면 비디오 원본의 형식을 반환합니다. MCI는 형식에 대해 "ntsc", "rgb", "pal", "secam", "svideo" 및 "generic" 상수를 정의합니다. 반환된 각 형식의 원본이 두 개 이상 있을 수 있습니다. 해당 커넥터에 대해 둘 이상의 신호가 허용되는 경우 "제네릭" 소스 형식이 사용됩니다.
비디오 원본 수 총 비디오 입력 수를 반환합니다.
비디오 원본 번호 인덱스 원본 인덱스의 비디오 입력 유형을 반환합니다.
비디오 스트림 명령이 작업 영역과 연결된 비디오 스트림의 이름을 검색해야 한다고 지정합니다. 이러한 문자열(예: "재미있는 엔딩" 또는 "슬픈 끝")은 파일에 포함되고 스트림을 식별합니다.

lpszFlags

"wait", "notify" 또는 "test"일 수 있습니다. 이러한 플래그에 대한 자세한 내용은 대기, 알림 및 테스트 플래그를 참조하세요.

반환 값

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

설명

VCR 디바이스의 경우 "비디오 원본" 또는 "오디오 원본"을 "개수" 또는 "숫자" 플래그로 지정해야 합니다. "count"를 지정하면 비디오 또는 오디오의 총 입력 수가 반환됩니다. "number"를 지정하면 드라이버는 입력에 해당하는 형식을 반환합니다. 형식은 "tuner", "line", "svideo", "aux" 또는 "generic" 중 하나일 수 있습니다. 일반적으로 먼저 VCR에서 "개수"를 쿼리한 다음 개수를 "number" 플래그의 범위로 사용해야 합니다. "원본" 숫자는 1부터 시작합니다.

요구 사항

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

추가 정보

Mci

MCI 명령 문자열