where 명령

where 명령은 원본 또는 대상 영역을 지정하는 사각형을 검색합니다. 이 사각형은 put 명령을 사용하여 지정되었습니다. 디지털 비디오 및 비디오 오버레이 디바이스는 이 명령을 인식합니다.

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

_stprintf_s(
  lpszCommand, 
  TEXT("where %s %s %s"), 
  lpszDeviceID, 
  lpszRequestRect, 
  lpszFlags
); 

매개 변수

lpszDeviceID

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

lpszRequestRect

차원이 검색되는 사각형을 식별하는 플래그입니다. 다음 표에서는 where 명령 및 각 형식에서 사용하는 플래그를 인식하는 디바이스 유형을 나열합니다.

값	의미	의미
digitalvideo	destinationdestination maxframeframe maxsource	source maxvideovideo maxwindowwindow max
오버레이	destinationframe	sourcevideo

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

값	의미
destination	대상 오프셋 및 익스텐트 검색 비디오 오버레이 디바이스의 경우 대상 사각형은 프레임 버퍼의 이미지 데이터를 표시하는 표시 창 클라이언트 영역의 영역을 정의합니다.
destination max	클라이언트 사각형의 현재 크기를 검색합니다.
frame	프레임 버퍼 사각형의 오프셋 및 범위를 검색합니다. 프레임 버퍼 사각형은 들어오는 비디오 데이터를 수신하는 프레임 버퍼의 영역을 정의합니다. "비디오" 사각형의 이미지는 이 영역으로 크기가 조정됩니다.
frame max	프레임 버퍼의 최대 크기를 반환합니다.
source	원본 오프셋 및 익스텐트 검색 비디오 오버레이 디바이스의 경우 원본 사각형은 대상 창에 표시되는 프레임 버퍼의 영역을 정의합니다. 디바이스는 이 사각형을 사용하여 디스플레이의 대상 사각형에 맞게 확장되기 전에 이미지를 자립니다.
source max	프레임 버퍼의 최대 크기를 검색합니다.
비디오	비디오 사각형의 오프셋 및 익스텐트를 검색합니다. 비디오 사각형은 프레임 버퍼로 전송되는 들어오는 비디오 데이터의 영역을 정의합니다.
video max	입력의 최대 크기를 반환합니다.
시간 범위	디스플레이 창 프레임의 현재 크기와 위치를 검색합니다.
window max	전체 디스플레이의 크기를 검색합니다.

lpszFlags

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

반환 값

mciSendString 함수의 lpszReturnString 매개 변수에서 사각형을 반환합니다. 사각형은 이 명령의 lpszRequestRect 매개 변수에 지정된 영역을 설명합니다. 사각형은 X1 Y1 X2 Y2로 지정됩니다. 좌표 X1 Y1 은 사각형의 왼쪽 위 모서리를 지정하고 좌표 X2 Y2 는 너비와 높이를 지정합니다.

예제

다음 명령은 "동영상" 디바이스의 표시 사각형을 반환합니다.

where movie destination

요구 사항

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

추가 정보

Mci

MCI 명령 문자열

넣어