MCI_LIST 명령
MCI_LIST 명령은 디바이스에서 사용할 수 있는 입력의 수와 유형에 대한 정보를 가져옵니다. 디지털 비디오 및 VCR 디바이스는 이 명령을 인식합니다.
이 명령을 보내려면 다음 매개 변수를 사용하여 mciSendCommand 함수를 호출합니다.
MCIERROR mciSendCommand(
MCIDEVICEID wDeviceID,
MCI_LIST,
DWORD dwFlags,
(DWORD) (LPMCI_GENERIC_PARMS) lpList
);
매개 변수
-
wDeviceID
-
명령 메시지를 받을 MCI 디바이스의 디바이스 식별자입니다.
-
dwFlags
-
MCI_NOTIFY, MCI_WAIT 또는 MCI_TEST. 이러한 플래그에 대한 자세한 내용은 대기, 알림 및 테스트 플래그를 참조 하세요.
-
lpList
-
MCI_GENERIC_PARMS 구조체에 대한 포인터입니다. (확장 명령 집합이 있는 디바이스는 이 구조를 디바이스별 구조로 바꿀 수 있습니다.)
Return Value
성공하면 0을 반환하고, 그렇지 않으면 오류를 반환합니다.
설명
digitalvideo 디바이스 유형에 적용되는 추가 플래그는 다음과 같습니다.
-
MCI_DGV_LIST_ALG
-
lpList로 식별되는 구조체의 lpstrAlgorithm 멤버는 알고리즘의 이름을 포함하는 버퍼의 주소를 포함합니다. 이름은 알고리즘과 연결된 품질 설명자의 유형을 검색하는 데 사용됩니다.
-
MCI_DGV_LIST_COUNT
-
지정된 형식의 옵션 수를 반환합니다.
-
MCI_DGV_LIST_ITEM
-
목록 형식을 나타내는 상수는 lpList로 식별되는 구조체의 dwItem 멤버에 포함됩니다. 이 플래그는 필수입니다. 다음 상수 중 하나를 사용하여 목록 유형을 나타냅니다.
-
MCI_DGV_LIST_AUDIO_ALG
-
명령은 오디오 알고리즘의 이름을 검색해야 합니다.
-
MCI_DGV_LIST_AUDIO_QUALITY
-
명령은 오디오 품질 수준을 검색해야 합니다. 반환되는 수준은 lpList로 식별된 구조체의 lpstrAlgorithm 멤버가 참조하는 알고리즘과 연결됩니다. "current" 문자열을 사용하여 해당 멤버를 지정하면 현재 알고리즘과 연결된 품질이 반환됩니다.
-
MCI_DGV_LIST_AUDIO_STREAM
-
명령은 오디오 스트림의 이름을 검색해야 합니다.
-
MCI_DGV_LIST_STILL_AL
-
명령은 스틸 알고리즘의 이름을 검색해야 합니다.
-
MCI_DGV_LIST_STILL_QUALITY
-
명령은 품질 수준을 검색해야 합니다. 반환되는 수준은 lpList로 식별된 구조체의 lpstrAlgorithm 멤버가 참조하는 알고리즘과 연결됩니다. "current" 문자열을 사용하여 해당 멤버를 지정하면 현재 알고리즘과 연결된 품질이 반환됩니다.
-
MCI_DGV_LIST_VIDEO_ALG
-
이 명령은 비디오 알고리즘의 이름을 검색해야 합니다.
-
MCI_DGV_LIST_VIDEO_QUALITY
-
이 명령은 비디오 품질 수준을 검색해야 합니다. 반환되는 수준은 lpList로 식별된 구조체의 lpstrAlgorithm 멤버가 참조하는 알고리즘과 연결됩니다. "current" 문자열을 사용하여 해당 멤버를 지정하면 현재 알고리즘과 연결된 품질이 반환됩니다.
-
MCI_DGV_LIST_VIDEO_SOURCE
-
이 명령은 비디오 원본에 대한 정보를 반환해야 합니다. MCI_DGV_LIST_COUNT 함께 사용하면 명령이 비디오 원본 수를 반환합니다. MCI_DGV_LIST_NUMBER 함께 사용하면 명령이 비디오 원본의 형식을 반환합니다. MCI는 다음 형식을 정의합니다.
- MCI_DGV_SETVIDEO_SRC_GENERIC
- MCI_DGV_SETVIDEO_SRC_NTSC
- MCI_DGV_SETVIDEO_SRC_PAL
- MCI_DGV_SETVIDEO_SRC_RGB
- MCI_DGV_SETVIDEO_SRC_SECAM
- MCI_DGV_SETVIDEO_SRC_SVIDEO
반환된 각 형식의 원본이 두 개 이상 있을 수 있습니다. 제네릭 소스 형식은 해당 커넥터에 대해 둘 이상의 신호 형식이 허용되는 경우에 사용됩니다.
-
MCI_DGV_LIST_VIDEO_STREAM
-
이 명령은 비디오 스트림의 이름을 검색해야 합니다.
-
MCI_DGV_LIST_NUMBER
-
인덱스는 lpList로 식별되는 구조체의 dwNumber 멤버에 지정됩니다. 인덱스가 1과 MCI_DGV_LIST_COUNT 플래그에 대해 반환된 값 사이의 정수여야 합니다.
디지털 비디오 디바이스의 경우 lpList는 MCI_DGV_LIST_PARMS 구조를 가리킵니다.
다음 추가 플래그는 vcr 디바이스 유형에 적용합니다.
-
MCI_VCR_LIST_AUDIO_SOURCE
-
오디오 입력 또는 유형을 나열합니다.
-
MCI_VCR_LIST_COUNT
-
lpList로 식별되는 구조체의 dwReturn 멤버를 총 비디오 또는 오디오 입력 수로 설정합니다.
-
MCI_VCR_LIST_NUMBER
-
lpList로 식별되는 구조체의 dwReturn 멤버를 dwNumber 멤버가 지정한 비디오 또는 오디오 입력 형식으로 설정합니다.
-
MCI_VCR_LIST_VIDEO_SOURCE
-
비디오 입력 또는 형식을 나열합니다.
VCR 디바이스의 경우 lpList는 MCI_VCR_LIST_PARMS 구조를 가리킵니다.
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 |
Windows 2000 Professional[데스크톱 앱만] |
지원되는 최소 서버 |
Windows 2000 Server[데스크톱 앱만] |
헤더 |
|