MCI_PUT 명령

  • 아티클

MCI_PUT 명령은 원본, 대상 및 프레임 사각형을 설정합니다. 디지털 비디오 및 비디오 오버레이 디바이스는 이 명령을 인식합니다.

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

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_PUT, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_GENERIC_PARMS) lpDest
);

매개 변수

wDeviceID

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

dwFlags

디지털 비디오 디바이스의 경우 MCI_NOTIFY, MCI_WAIT 또는 MCI_TEST. 이러한 플래그에 대한 자세한 내용은 대기, 알림 및 테스트 플래그를 참조하세요.

lpDest

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

반환 값

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

설명

digitalvideo 디바이스 유형에 다음과 같은 추가 플래그가 사용됩니다.

MCI_DGV_PUT_CLIENT

MCI_DGV_RECT 대해 정의된 사각형은 클라이언트 창의 위치에 적용됩니다. 지정된 사각형은 표시 창의 부모 창을 기준으로 합니다. MCI_DGV_PUT_WINDOW 이 플래그와 동시에 설정해야 합니다.

MCI_DGV_PUT_DESTINATION

MCI_DGV_RECT 대해 정의된 사각형은 대상 사각형을 지정합니다. 대상 사각형은 이미지 또는 비디오를 보여 주는 이 디바이스 드라이버 instance 연결된 클라이언트 창의 부분을 지정합니다.

MCI_DGV_PUT_FRAME

MCI_DGV_RECT 대해 정의된 사각형은 프레임 사각형에 적용됩니다. 프레임 사각형은 비디오 사각형에서 가져온 비디오 이미지의 대상으로 사용되는 프레임 버퍼의 부분을 지정합니다. 비디오는 프레임 버퍼 사각형 내에 맞게 크기를 조정해야 합니다.

사각형은 프레임 버퍼 좌표로 지정됩니다. 기본 사각형은 전체 프레임 버퍼입니다. 이 사각형을 지정하면 디바이스가 데이터를 디지털화할 때 이미지의 크기를 조정할 수 있습니다. 이미지 크기를 조정할 수 없는 디바이스는 MCIERR_UNSUPPORTED_FUNCTION 이 명령을 거부합니다. MCI_GETDEVCAPS 명령과 함께 MCI_GETDEVCAPS_CAN_STRETCH 플래그를 사용하여 디바이스가 이미지의 크기를 조정하는지 확인할 수 있습니다. 디바이스는 이미지 크기를 조정할 수 없는 경우 FALSE 를 반환합니다.

MCI_DGV_PUT_SOURCE

MCI_DGV_RECT 대해 정의된 사각형은 원본 사각형을 지정합니다. 원본 사각형은 대상 사각형에 맞게 크기를 조정할 프레임 버퍼 부분을 지정합니다.

MCI_DGV_PUT_VIDEO

MCI_DGV_RECT 대해 정의된 사각형은 비디오 사각형에 적용됩니다. 비디오 사각형은 현재 프레젠테이션 원본의 어느 부분이 프레임 버퍼에 저장되어 있는지 지정합니다. 사각형은 프레젠테이션 원본의 자연 좌표를 사용하여 지정됩니다. 프레임 버퍼에 이미지와 비디오를 저장하기 전에 발생하는 자르기 사양을 허용합니다. 기본 사각형은 전체 활성 검사 영역 또는 압축 해제된 전체 이미지 및 비디오입니다.

MCI_DGV_PUT_WINDOW

MCI_DGV_RECT 대해 정의된 사각형은 표시 창에 적용됩니다. 이 사각형은 디스플레이 창의 부모 창(일반적으로 바탕 화면)을 기준으로 합니다. 창을 지정하지 않으면 기본값은 초기 창 크기 및 위치입니다.

MCI_DGV_RECT

lpDest로 식별된 구조체의 rc 멤버에는 유효한 사각형이 포함되어 있습니다.

디지털 비디오 디바이스의 경우 lpDest 는 MCI_DGV_PUT_PARMS 구조를 가리킵니다.

오버레이 디바이스 유형에 다음과 같은 추가 플래그가 사용됩니다.

MCI_OVLY_PUT_DESTINATION

MCI_OVLY_RECT 대해 정의된 사각형은 이미지를 표시하는 데 사용되는 클라이언트 창의 영역을 지정합니다. 사각형에는 창 원본을 기준으로 이미지의 오프셋 및 표시 범위가 포함됩니다. 프레임이 늘어나면 원본이 대상 사각형으로 확장됩니다.

MCI_OVLY_PUT_FRAME

MCI_OVLY_RECT 대해 정의된 사각형은 비디오 이미지를 수신하는 데 사용되는 비디오 버퍼의 영역을 지정합니다. 사각형에는 비디오 버퍼 원본을 기준으로 버퍼 영역의 오프셋 및 범위가 포함됩니다.

MCI_OVLY_PUT_SOURCE

MCI_OVLY_RECT 정의된 사각형은 디지털 이미지의 원본으로 사용되는 비디오 버퍼의 영역을 지정합니다. 사각형에는 원본을 기준으로 비디오 버퍼에 대한 클리핑 사각형의 오프셋 및 범위가 포함됩니다.

MCI_OVLY_PUT_VIDEO

MCI_OVLY_RECT 대해 정의된 사각형은 비디오 버퍼에 의해 비디오 원본 캡처의 영역을 지정합니다. 사각형에는 원본을 기준으로 비디오 원본에 대한 클리핑 사각형의 오프셋 및 범위가 포함됩니다.

MCI_OVLY_RECT

lpDest로 식별된 구조체의 rc 멤버에는 유효한 디스플레이 사각형이 포함되어 있습니다. 이 플래그를 지정하지 않으면 기본 사각형이 잘리는 비디오 버퍼 또는 창의 좌표와 일치합니다.

비디오 오버레이 디바이스의 경우 lpDest 는 MCI_OVLY_RECT_PARMS 구조를 가리킵니다.

요구 사항

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

추가 정보

Mci

MCI 명령