window 명령

창 명령은 표시 창을 제어합니다. 이 명령을 사용하여 창의 표시 특성을 변경하거나 드라이버가 기본 표시 창 대신 사용할 대상 창을 제공할 수 있습니다. 디지털 비디오 및 비디오 오버레이 디바이스는 이 명령을 인식합니다.

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

_stprintf_s(
  lpszCommand, 
  TEXT("window %s %s %s"), 
  lpszDeviceID, 
  lpszWindowFlags, 
  lpszFlags
); 

매개 변수

lpszDeviceID

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

lpszWindowFlags

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

값	의미	의미
digitalvideo	handle hwnd state hidestate minimizestate restorestate showshow maximized	show minimizedshow min noactiveshow nashow noactivateshow normaltext 캡션
오버레이	fixedhandle defaulthandle hwnd state hidestate iconicstate maximizedstate minimizestate minimizedstate no actionstate noactivatestate normal	state restorestate showshow maximizedshow minimizedshow min noactiveshow nashow noactivateshow normalstretchtext 캡션

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

값	의미
고정	이미지의 스트레칭을 사용하지 않도록 설정합니다.
handle default	디바이스가 열린 작업 중에 만든 기본 창으로 디스플레이 창을 다시 설정하도록 지정합니다. 비디오 오버레이 디바이스의 경우 디바이스가 자체 대상 창을 만들고 관리해야 한다고 지정합니다.
핸들 hwnd	기본 창 대신 사용할 대상 창의 핸들을 지정합니다. hwnd 매개 변수에는 CreateWindow 함수에서 반환하는 창 핸들에 해당하는 ASCII 숫자가 포함됩니다. 두 디바이스 인스턴스는 각 instance 다른 instance 없는 것처럼 창의 비디오 및 이미지 픽셀을 업데이트하는 경우 동일한 창 핸들을 사용할 수 있습니다. setvideo "off"로 비디오 출력을 사용하지 않도록 설정하면 업데이트 명령이 대상 사각형을 단색으로 만듭니다.
최대화된 표시	대상 창을 최대화합니다.
최소 noactive 표시	대상 창을 아이콘으로 표시합니다.
최소화된 표시	대상 창을 최소화합니다.
show na	대상 창을 현재 상태로 표시합니다. 현재 활성 상태인 창은 활성 상태로 유지됩니다.
noactivate 표시	대상 창을 가장 최근의 크기와 위치로 표시합니다. 현재 활성 상태인 창은 활성 상태로 유지됩니다.
show normal	대상 창을 활성화하고 원래 크기와 위치에 표시합니다. (이는 "상태 복원" 플래그와 동일합니다.)
상태 숨기기	대상 창을 숨깁니다.
상태 아이콘	대상 창을 아이콘으로 표시합니다.
상태가 최대화됨	대상 창을 최대화합니다.
상태 최소화	대상 창을 최소화하고 window-manager 목록에서 최상위 창을 활성화합니다.
상태가 최소화됨	대상 창을 최소화합니다.
state no action	대상 창을 현재 상태로 표시합니다. 현재 활성 상태인 창은 활성 상태로 유지됩니다.
state noactivate	대상 창을 가장 최근의 크기와 상태로 표시합니다. 현재 활성 창은 활성 상태로 남습니다.
state normal	대상 창을 활성화하고 원래 크기와 위치에 표시합니다.
상태 복원	대상 창을 활성화하고 원래 크기와 위치에 표시합니다.
state show	대상 창을 표시합니다.
늘이기(stretch)	이미지의 스트레칭을 사용하도록 설정합니다.
텍스트 캡션	대상 창의 캡션 지정합니다. 이 텍스트에 포함된 공백이 포함된 경우 전체 캡션 따옴표로 묶어야 합니다. 기본 창의 기본 캡션 비어 있습니다.

lpszFlags

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

반환 값

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

설명

비디오 오버레이 디바이스는 일반적으로 창을 만들고 열 때 표시합니다. 애플리케이션이 드라이버에 창을 제공하는 경우 애플리케이션은 창으로 전송된 메시지를 관리해야 합니다.

상태 명령을 사용하여 드라이버 표시 창에 대한 핸들을 검색할 수 있으므로 표준 창 관리자 함수(예: ShowWindow)를 사용하여 창을 조작할 수도 있습니다.

예제

다음 명령은 "동영상" 재생 창의 캡션 표시하고 설정합니다.

window movie text "Welcome to the Movies" state show

요구 사항

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

추가 정보

Mci

MCI 명령 문자열

열기

재생

setvideo

update