MCI_SETVIDEO 명령

  • 아티클

MCI_SETVIDEO 명령은 비디오 재생과 관련된 값을 설정합니다. 디지털 비디오 및 VCR 디바이스는 이 명령을 인식합니다.

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

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_SETVIDEO, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_GENERIC_PARMS) lpSetVideo
);

매개 변수

wDeviceID

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

dwFlags

MCI_NOTIFY, MCI_WAIT 또는 MCI_TEST. 이러한 플래그에 대한 자세한 내용은 대기, 알림 및 테스트 플래그를 참조하세요.

lpSetVideo

MCI_GENERIC_PARMS 구조체에 대한 포인터입니다. (확장 명령 집합이 있는 디바이스는 이 구조를 디바이스별 구조로 대체할 수 있습니다.)

반환 값

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

설명

다음 추가 플래그는 "digitalvideo" 디바이스 유형과 함께 사용됩니다.

MCI_DGV_SETVIDEO_ALG

lpSetVideo로 식별되는 구조체의 lpstrAlgorithm 멤버는 비디오 압축 알고리즘의 이름을 포함하는 버퍼의 주소를 포함합니다. 압축 알고리즘은 후속 MCI_RESERVE 또는 MCI_RECORD 명령에 사용됩니다. 사용 가능한 알고리즘은 디바이스에 따라 다릅니다.

지정된 알고리즘이 현재 파일 형식과 호환되지 않는 경우 파일 형식이 알고리즘의 기본 형식으로 변경됩니다.

MCI_DGV_SETVIDEO_CLOCKTIME

MCI_DGV_SETVIDEO_OVER 사용하는 경우 시간은 밀리초 단위로 지정되고 절대 시간임을 나타냅니다. (이번에는 작업 영역의 재생 단계가 아닙니다.)

MCI_DGV_SETVIDEO_INPUT

입력 신호에 영향을 미치고 기록되는 내용을 수정할 수 있도록 MCI_DGV_SETVIDEO_BRIGHTNESS, MCI_DGV_SETVIDEO_COLOR, MCI_DGV_SETVIDEO_CONTRAST, MCI_DGV_SETVIDEO_GAMMA, MCI_DGV_SETVIDEO_SHARPNESS 또는 MCI_DGV_SETVIDEO_TINT 수정합니다. 가능한 경우 입력을 모니터링할 때 기본값입니다.

MCI_DGV_SETVIDEO_ITEM

비디오 상수는 lpSetVideo로 식별된 구조체의 dwItem 멤버에 지정됩니다. 상수는 설정되는 값을 식별합니다. 이 플래그를 사용하여 다음 상수를 지정할 수 있습니다.

MCI_AVI_SETVIDEO_DRAW_PROCEDURE

lpSetVideo로 식별된 구조체의 dwValue 멤버에 새 그리기 프로시저 주소가 지정됩니다. 디바이스가 유휴 상태인 경우에만 새 그리기 프로시저를 지정할 수 있습니다. 이 플래그는 MCIAVI 디지털 비디오 드라이버에서만 인식됩니다. 문자열 명령 인터페이스에는 이 플래그와 동일하지 않습니다.

MCI_AVI_SETVIDEO_PALETTE_COLOR

lpSetVideo로 식별된 구조체의 dwOver 및 dwValue 멤버에 새 색상표 색이 지정됩니다. dwOver 멤버는 변경할 색의 색상표 인덱스를 지정하고 dwValue 멤버는 새 색을 RGB 값으로 지정합니다. 또한 이 상수를 사용할 때 MCI_DGV_SETVIDEO_ITEMMCI_DGV_SETVIDEO_OVER 및 MCI_DGV_SETVIDEO_VALUE 플래그를 지정해야 합니다. 이 플래그는 MCIAVI 디지털 비디오 드라이버에서만 인식됩니다.

MCI_AVI_SETVIDEO_PALETTE_HALFTONE

기본 색상표 대신 하프톤 팔레트를 사용해야 했음을 나타냅니다. 이 플래그는 MCIAVI 디지털 비디오 드라이버에서만 인식됩니다.

MCI_DGV_SETVIDEO_BITSPERPEL

픽셀당 비트 수는 lpSetVideo로 식별된 구조체의 dwValue 멤버에 지정됩니다. 픽셀당 비트 수는 캡처되거나 기록된 데이터를 저장하는 데 사용됩니다.

MCI_DGV_SETVIDEO_BRIGHTNESS

비디오 밝기 수준은 lpSetVideo로 식별된 구조체의 dwValue 멤버에 있는 요소로 지정됩니다.

MCI_DGV_SETVIDEO_COLOR

비디오 색 채도 수준은 lpSetVideo로 식별된 구조체의 dwValue 멤버에 있는 요소로 지정됩니다.

MCI_DGV_SETVIDEO_CONTRAST

비디오 대비 수준은 lpSetVideo로 식별된 구조체의 dwValue 멤버에 있는 요소로 지정됩니다.

MCI_DGV_SETVIDEO_FRAME_RATE

프레임 속도는 lpSetVideo로 식별된 구조체의 dwValue 멤버에 지정됩니다. 속도는 초당 프레임 단위로 1000배로 지정됩니다. 예를 들어 초당 29.97프레임을 29970으로 지정합니다.

MCI_DGV_SETVIDEO_GAMMA

감마 수정 지수 값은 lpSetVideo로 식별된 구조체의 dwValue 멤버에 지정됩니다. 감마 보정은 프레젠테이션 원본에서 인코딩된 강도와 표시된 밝기 사이의 매핑을 조정합니다. 값은 지수에 1000을 곱한 값입니다. 예를 들어 2200은 지수 2.2를 나타냅니다. 값 1000은 감마 수정을 적용하지 않는 지수 1을 나타냅니다.

MCI_DGV_SETVIDEO_KEY_COLOR

키 색은 lpSetVideo로 식별된 구조체의 dwValue 멤버에 지정됩니다. 키 색은 RGB 값입니다.

MCI_DGV_SETVIDEO_KEY_INDEX

키 인덱스 값은 lpSetVideo로 식별된 구조체의 dwValue 멤버에 지정됩니다. 인덱스 매개 변수는 실제 색상표 인덱스입니다.

MCI_DGV_SETVIDEO_PALHANDLE

팔레트 핸들은 lpSetVideo로 식별된 구조체의 dwValue 멤버에 지정됩니다. 색상표 핸들은 낮은 순서의 단어에 포함되어 있습니다. 디지털 비디오 디바이스는 이 명령과 함께 전달된 팔레트를 해제해서는 안 됩니다. 애플리케이션은 디바이스를 닫은 후 해제해야 합니다. 이 플래그는 팔레트를 사용하는 디바이스에서만 지원됩니다. 지정된 색상표 핸들이 0이면 기본 색상표가 사용됩니다.

MCI_DGV_SETVIDEO_SHARPNESS

비디오 선명도 값은 lpSetVideo로 식별된 구조체의 dwValue 멤버에 있는 요소로 지정됩니다.

MCI_DGV_SETVIDEO_SOURCE

비디오 입력의 원본을 지정하는 상수는 lpSetVideo로 식별된 구조체의 dwValue 멤버에 지정됩니다. 다음 상수가 정의됩니다.

  • MCI_DGV_SETVIDEO_SRC_NTSC: NTSC 텔레비전.
  • MCI_DGV_SETVIDEO_SRC_PAL: PAL 텔레비전.
  • MCI_DGV_SETVIDEO_SRC_RGB: RGB 비디오.
  • MCI_DGV_SETVIDEO_SRC_SECAM: SECAM 텔레비전.
  • MCI_DGV_SETVIDEO_SRC_SVIDEO: S-Video.

MCI_DGV_SETVIDEO_STREAM

비디오 스트림은 lpSetVideo로 식별된 구조체의 dwValue 멤버에 지정됩니다. 정수 값은 작업 영역에서 재생된 비디오 스트림을 지정합니다. 스트림을 지정하지 않고 파일 형식이 기본 스트림을 정의하지 않으면 첫 번째 물리적으로 인터리브된 비디오 스트림이 재생됩니다.

MCI_DGV_SETVIDEO_TINT

비디오 색조 값은 lpSetVideo로 식별된 구조체의 dwValue 멤버에 있는 요소로 지정됩니다. 일반적으로 이 조정은 250이 녹색으로 정의되고 750이 빨간색으로 정의되고 0(또는 1000)이 파란색으로 정의된 여러 색 TV 세트의 색조 컨트롤을 기준으로 모델링됩니다. 명목 값은 항상 500입니다.

MCI_DGV_SETVIDEO_OUTPUT

MCI_DGV_SETVIDEO_BRIGHTNESS, MCI_DGV_SETVIDEO_COLOR, MCI_DGV_SETVIDEO_CONTRAST, MCI_DGV_SETVIDEO_GAMMA, MCI_DGV_SETVIDEO_SHARPNESS 또는 MCI_DGV_SETVIDEO_TINT 플래그는 표시된 신호에만 영향을 미치며 기록된 플래그에는 영향을 미치지 않도록 수정됩니다. 가능하면 파일을 모니터링할 때 기본값입니다.

MCI_DGV_SETVIDEO_OVER

전환 길이 매개 변수는 lpSetVideo로 식별된 구조체의 dwOver 멤버에 포함됩니다. 전환 길이는 변경에 걸리는 시간(현재 시간 형식)을 지정합니다. 이 플래그를 사용하지 않으면 변경 내용이 즉시 발생합니다.

MCI_DGV_SETVIDEO_QUALITY

lpSetVideo로 식별되는 구조체의 lpstrQuality 멤버에는 비디오 품질을 설명하는 버퍼의 주소가 포함되어 있습니다. 버퍼의 텍스트 문자열은 비디오 압축 알고리즘의 특성을 지정합니다.

MCI_DGV_SETVIDEO_ALG 플래그를 사용하여 지정된 알고리즘에 대한 품질 설명자를 선택할 수 있습니다. 이 플래그를 생략하면 현재 알고리즘이 사용됩니다.

사용 가능한 알고리즘 및 설명자 이름은 디바이스에 따라 달라집니다. 각 디바이스는 사용 가능한 알고리즘에 대한 설명서와 해당 설명자 이름에 대한 설명을 제공합니다. MCI_QUALITY 명령은 추가 설명자 이름을 정의할 수 있습니다. 모든 디바이스는 "low", "medium" 및 "high" 설명자를 지원합니다. 기본값은 드라이버별입니다.

MCI_DGV_SETVIDEO_RECORD

녹화에 비디오 데이터가 포함되거나 제외되는지 여부를 지정합니다. MCI_SET_ON 결합하면 비디오 데이터가 기록됩니다. MCI_SET_OFF 함께 사용하면 비디오 데이터가 제외됩니다. 기본값에는 비디오 데이터가 포함됩니다.

MCI_DGV_SETVIDEO_SRC_NUMBER

비디오 원본에 대한 숫자는 lpSetVideo로 식별된 구조체의 dwSourceNumber 멤버에 지정됩니다. MCI_DGV_SETVIDEO_VALUE 지정된 형식의 입력이 두 개 이상 있는 경우 값은 입력을 선택합니다. 이 플래그는 항상 MCI_DGV_SETVIDEO_SOURCE 함께 사용해야 합니다. 그러나 MCI_DGV_SETVIDEO_VALUE 생략하면 지정된 원본 번호는 MCI_LIST 명령에 지정된 대로 사용할 절대 원본을 나타냅니다.

MCI_DGV_SETVIDEO_STILL

지정된 알고리즘 이름 또는 품질 값은 스틸 이미지에 적용됩니다.

모든 디바이스 드라이버는 "none"의 알고리즘을 지원해야 합니다. 즉, 압축이 없음을 의미합니다. 이것이 기본값입니다. 이 경우 디지털 비디오 디바이스는 스틸 이미지를 RGB DIB(디바이스 독립적 비트맵)로 저장합니다.

MCI_DGV_SETVIDEO_VALUE

값은 lpSetVideo로 식별된 구조체의 dwValue 멤버에 포함됩니다. 값의 의미는 MCI_DGV_SETVIDEO_ITEM 플래그로 지정됩니다.

MCI_SET_OFF

비디오 출력을 사용하지 않도록 설정합니다. 디지털 비디오 디바이스의 경우 비디오를 사용하지 않도록 설정하면 MCI_PUT 명령(또는 현재 창의 기본 클라이언트 영역)에 정의된 대상 사각형의 픽셀이 단색으로 설정되지만 프레임 버퍼에는 영향을 주지 않습니다. 원하는 경우 MCI_WINDOW 명령을 사용하여 창을 숨길 수 있습니다. 작업 영역이든 외부 입력이든 비디오 원본은 프레임 버퍼에 새 이미지를 계속 저장할 수 있지만 비디오가 활성화될 때까지 표시되지 않습니다. 애플리케이션은 MCI_SETVIDEO 명령을 사용하여 이 기능을 제어해야 하지만 디지털 비디오 디바이스는 이 플래그를 계속 지원해야 합니다. 열기 후의 기본값이 켜집니다.

MCI_SET_ON

비디오 출력을 사용하도록 설정합니다.

디지털 비디오 디바이스의 경우 lpSetVideo 매개 변수는 MCI_DGV_SETVIDEO_PARMS 구조를 가리킵니다.

다음 추가 플래그는 "vcr" 디바이스 유형과 함께 사용됩니다.

MCI_VCR_SETVIDEO_RECORD

비디오 녹화를 켜거나 끄기로 설정합니다. 다음 플래그 중 하나와 함께 사용됩니다.

  • MCI_SET_ON. 비디오 녹화.
  • MCI_SET_OFF. 비디오 녹화를 해제합니다. 비디오 녹화를 해제하려면 먼저 어셈블 녹화를 해제해야 할 수 있습니다( MCI_VCR_SET_ASSEMBLE_RECORD 플래그가 꺼진 상태에서 MCI_SET 명령을 사용).

MCI_TRACK

lpSetVideo로 식별된 구조체의 dwTrack 멤버는 명령의 영향을 받는 트랙을 지정합니다.

MCI_VCR_SETVIDEO_SOURCE

비디오 원본을 설정하고 MCI_VCR_SETVIDEO_TO 플래그와 함께 사용해야 합니다.

MCI_VCR_SETVIDEO_MONITOR

비디오 원본 모니터를 설정하고 MCI_VCR_SETVIDEO_TO 플래그와 함께 사용해야 합니다.

MCI_VCR_SETVIDEO_TO

lpSetVideo로 식별되는 구조체의 dwTo 멤버에는 다음 상수 중 하나가 포함됩니다.

**MCI\_VCR\_SRC\_TYPE\_TUNER**
**MCI\_VCR\_SRC\_TYPE\_LINE**
**MCI\_VCR\_SRC\_TYPE\_AUX**
**MCI\_VCR\_SRC\_TYPE\_GENERIC**
**MCI\_VCR\_SRC\_TYPE\_MUTE**
**MCI\_VCR\_SRC\_TYPE\_OUTPUT**
**MCI\_VCR\_SRC\_TYPE\_RGB**
**MCI\_VCR\_SETVIDEO\_NUMBER**

lpSetVideo로 식별되는 구조체의 dwNumber 멤버에는 사용할 비디오 입력(dwTo 멤버에 지정된 형식)이 포함됩니다.

VCR 디바이스의 경우 lpSetVideo 매개 변수는 MCI_VCR_SETVIDEO_PARMS 구조를 가리킵니다.

요구 사항

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

추가 정보

Mci

MCI 명령