freeze 명령

Freeze 명령은 VCR에서 비디오 입력 또는 비디오 출력을 고정하거나 프레임 버퍼에 대한 비디오 획득을 사용하지 않도록 설정합니다. 디지털 비디오, 비디오 오버레이 및 VCR 디바이스는 이 명령을 인식합니다.

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

_stprintf_s(
  lpszCommand, 
  TEXT("freeze %s %s %s"), 
  lpszDeviceID, 
  lpszFreezeFlags, 
  lpszFlags
);

매개 변수

lpszDeviceID

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

lpszFreezeFlags

고정할 내용을 식별하는 플래그입니다. 다음 표에는 고정 명령을 인식하는 디바이스 유형과 각 형식에서 사용하는 플래그가 나열되어 있습니다.

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

값	의미
직사각형에서	고정할 지역을 지정합니다. 비디오 오버레이 디바이스의 경우 이 지역에는 비디오 획득을 사용하지 않도록 설정됩니다. 디지털 비디오 디바이스의 경우 사각형 내의 픽셀은 잠금 마스크 비트가 켜집니다("외부" 플래그가 지정되지 않은 경우). 사각형은 비디오 버퍼 원본을 기준으로 하며 X1 Y1 X2 Y2로 지정됩니다. 좌표 X1 Y1 은 사각형의 왼쪽 위 모서리를 지정하고 좌표 X2 Y2 는 너비와 높이를 지정합니다.
필드(field)	첫 번째 필드를 고정합니다. 필드는 기본적으로 가정됩니다(프레임이나 필드가 지정되지 않은 경우).
frame	전체 프레임을 고정하고 두 필드를 모두 표시합니다.
input	일시 중지 또는 실행 중이든 관계없이 입력 이미지의 현재 프레임을 고정합니다.
output	VCR에서 출력의 현재 프레임을 고정합니다. 고정이 실행되면 VCR이 재생 중이면 현재 프레임이 고정되고 VCR이 일시 중지됩니다. 이 명령을 실행할 때 VCR이 일시 중지되면 현재 프레임이 고정됩니다. 고정된 이미지는 고정되지 않은 명령이 실행될 때까지 출력 디바이스에 유지됩니다. "input" 또는 "output"을 지정하지 않으면 "output"이 사용됩니다.
외부	"at" 플래그를 사용하여 지정된 지역 외부의 영역이 고정되었음을 나타냅니다.

lpszFlags

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

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

VCR 디바이스에서 사용하는 경우 이 명령은 프레임 잡기 카드용입니다.

"at" 플래그를 사용하여 불규칙한 취득 지역을 지정하려면 일련의 고정 및 고정 해제 명령을 사용합니다. 일부 비디오 오버레이 디바이스는 취득 지역의 복잡성을 제한합니다.

이 명령은 "고정 가능" 플래그가 있는 capability 명령을 호출하면 TRUE가 반환되는 경우에만 지원됩니다.

다음 명령은 비디오 버퍼의 왼쪽 위 모서리에 있는 100픽셀 정사각형에서 비디오 취득을 사용하지 않도록 설정합니다.

freeze vboard at 0 0 100 100

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