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[데스크톱 앱만]
헤더
Mmsystem.h(Windows.h 포함)

참고 항목

Mci

MCI 명령