IDvdControl2::ActivateAtPosition 메서드(strmif.h)

[이 페이지와 연결된 기능인 DirectShow는 레거시 기능입니다. MediaPlayer, IMFMediaEngine 및 Media Foundation의 오디오/비디오 캡처로 대체되었습니다. 이러한 기능은 Windows 10 및 Windows 11 최적화되었습니다. 가능한 경우 새 코드에서 DirectShow 대신 MediaPlayer, IMFMediaEngine 및 오디오/비디오 캡처를 사용하는 것이 좋습니다. 가능한 경우 레거시 API를 사용하는 기존 코드를 다시 작성하여 새 API를 사용하도록 제안합니다.]

메서드는 ActivateAtPosition 마우스 포인터 위치 아래의 메뉴 단추를 활성화합니다.

구문

HRESULT ActivateAtPosition(
  [in] POINT point
);

매개 변수

[in] point

화면 픽셀 좌표로 클라이언트 창 영역을 가리킵니다.

반환 값

다음 값 중 하나를 반환합니다.

반환 코드	Description
S_OK	강조 표시된 단추 사각형에서 클릭이 발생했으며 단추가 성공적으로 활성화되었습니다.
E_INVALIDARG	포인트는 유효한 비디오 영역 외부에 있습니다.
E_UNEXPECTED	단추가 있지만 작동하지 않습니다.
VFW_E_DVD_INVALIDDOMAIN	DVD 탐색기가 메뉴 도메인에 없습니다.
VFW_E_DVD_NO_BUTTON	마우스 포인터 위치 아래에 메뉴 단추가 없습니다.
VFW_E_DVD_OPERATION_INHIBITED	UOP(사용자 작업) 컨트롤에 의해 작업이 억제됩니다.

설명

마우스 포인터 좌표는 클라이언트 영역의 왼쪽 윗부분에 상대적이며, 비디오가 레터박스 형식인 경우 반드시 비디오 표시 영역이 아닐 수도 있습니다.

사용자가 메뉴 단추 위에 마우스 포인터를 직접 이동하여 메뉴를 탐색할 때 이 메서드를 사용합니다. 사용자가 상대 단추를 사용하여 메뉴를 탐색하는 경우 대신 ActivateAtPositionActivateButton을 사용합니다.

다음 표에서는 이 메서드 이름이 해당하는 부록 J 명령 이름과 이 메서드가 유효한 도메인을 보여 줍니다.

부록 J 명령 이름	유효한 도메인
없음	DVD_DOMAIN_VideoManagerMenu DVD_DOMAIN_VideoTitleSetMenu

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	strmif.h(Dshow.h 포함)
라이브러리	Strmiids.lib

추가 정보

DVD 응용 프로그램

오류 및 성공 코드

IDvdControl2 인터페이스

DVD 메뉴 작업