MSWebDVD 개체
[이 페이지와 연결된 기능인 DirectShow는 레거시 기능입니다. MediaPlayer, IMFMediaEngine 및 Media Foundation의 오디오/비디오 캡처로 대체되었습니다. 이러한 기능은 Windows 10 및 Windows 11 최적화되었습니다. 가능한 경우 새 코드에서 DirectShow 대신 MediaPlayer, IMFMediaEngine 및 오디오/비디오 캡처를 사용하는 것이 좋습니다. 가능한 경우 레거시 API를 사용하는 기존 코드를 다시 작성하여 새 API를 사용하도록 제안합니다.]
참고
이 구성 요소는 Microsoft Windows 2000, Windows XP 및 Windows Server 2003 운영 체제에서 사용할 수 있습니다. 이후 버전에서는 변경되거나 제공되지 않을 수 있습니다.
참고
이 API는 더 이상 사용되지 않습니다. DirectShow의 DVD 재생 및 탐색에 대한 자세한 내용은 DVD 애플리케이션을 참조하세요.
MSWebDVD 개체의 메서드, 속성 및 이벤트를 사용하면 애플리케이션이 DVD-Video 탐색 및 재생의 모든 측면을 제어하고 디스크에서 정보를 검색할 수 있습니다. MSWebDVD 개체는 실제 탐색 작업을 수행하지 않습니다. 대신 명령을 DVD 탐색기 필터, DVD-Video 디스크를 읽는 Microsoft® DirectShow® 구성 요소에 전달합니다.
MSWebDVD 메서드 및 속성은 DVD 탐색기의 현재 상태 또는 디스크에 대한 정보 또는 둘 다에 따라 작동합니다. 부모 수준 및 기본 언어에 대한 사용자 기본 설정과 같은 레지스트리에 다양한 유형의 애플리케이션 관련 정보를 저장하고 검색하려면 MSDVDAdm 개체의 메서드를 사용합니다. DVDAdm 속성을 사용하여 이 개체에 액세스합니다.
참고
DirectX 9.0b를 기준으로 개체는 신뢰할 수 있는 영역에만 로드됩니다. 신뢰할 수 없는 영역에는 로드되지 않습니다.
범주별 메서드 및 속성
| 재생 | |
|---|---|
| CanStep | 로컬 시스템의 MPEG-2 디코더가 지정된 방향으로 프레임 스테핑을 수행할 수 있는지 여부를 결정합니다. |
| 꺼내기 | 디스크를 드라이브에서 또는 드라이브에 꺼내거나 삽입합니다. |
| FramesPerSecond | 현재 DVD 타이틀의 비디오 프레임 속도를 검색합니다. |
| 일시 중지 | 현재 위치에서 재생을 일시 중지합니다. |
| 재생 | 현재 DVD 타이틀을 재생합니다. |
| PlayAtTime | 지정된 시간에 현재 타이틀에서 재생을 시작합니다. |
| PlayAtTimeInTitle | 지정된 타이틀 내에서 지정된 시간에 재생을 시작합니다. |
| PlayBackwards | 지정된 속도로 현재 위치에서 뒤로 재생을 시작합니다. |
| PlayChapter | 현재 타이틀의 지정된 챕터에서 재생을 시작합니다. |
| PlayChapterInTitle | 지정된 제목에서 지정된 장을 재생합니다. |
| PlayChaptersAutoStop | 지정된 챕터 수에 대해 지정된 제목의 지정된 장에서 재생을 시작합니다. |
| PlayForwards | 지정된 속도로 현재 위치에서 정방향 재생을 시작합니다. |
| PlayNextChapter | 현재 타이틀의 다음 챕터에서 재생을 시작합니다. |
| PlayPeriodInTitleAutoStop | 지정된 중지 시간까지 지정된 타이틀의 지정된 시간에 재생을 시작합니다. |
| PlayPrevChapter | 현재 타이틀의 이전 챕터에서 재생을 시작합니다. |
| PlayTitle | 지정된 타이틀의 시작 부분에서 재생을 시작합니다. |
| ReplayChapter | 현재 챕터의 시작 부분에서 재생을 시작합니다. |
| 다시 시작 | 메뉴가 표시된 후 재생을 다시 시작합니다. |
| StillOff | 재생을 다시 시작하여 여전히 모드를 취소합니다. |
| 단계 | 지정된 프레임 수만큼 DVD-Video 스트림을 진행합니다. |
| Stop | 재생을 중지합니다. |
| 메뉴 | |
| ActivateAtPosition | 지정된 위치에 있는 메뉴 단추를 활성화합니다. |
| ActivateButton | 선택한 메뉴 단추를 활성화합니다. |
| ButtonsAvailable | 현재 메뉴의 총 단추 수를 검색합니다. |
| CurrentButton | 선택한 단추의 수를 검색합니다. |
| DefaultMenuLanguage | 디스크에서 기본 메뉴 언어를 검색합니다. |
| GetButtonAtPosition | 단추를 선택하거나 활성화하지 않고 지정된 좌표의 단추 수를 검색합니다. |
| GetButtonRect | 창 좌표에서 지정된 단추의 사각형을 검색합니다. |
| ReturnFromSubmenu | 하위 메뉴에서 부모 메뉴로 표시를 반환하거나 메뉴가 최상위 메뉴인 경우 현재 제목으로 표시를 반환합니다. |
| SelectAndActivateButton | 지정된 단추를 선택하고 활성화합니다. |
| SelectAtPosition | 지정된 위치에서 메뉴 단추를 선택합니다. |
| SelectLeftButton | 표시된 메뉴에서 왼쪽 방향 단추를 선택합니다. |
| SelectLowerButton | 표시된 메뉴에서 아래쪽 방향 단추를 선택합니다. |
| SelectRightButton | 표시된 메뉴에서 오른쪽 방향 단추를 선택합니다. |
| SelectUpperButton | 표시된 메뉴에서 위쪽 방향 단추를 선택합니다. |
| ShowMenu | 화면에 지정된 메뉴를 표시합니다. |
| 오디오 스트림 | |
| AudioStreamsAvailable | 현재 타이틀에서 사용할 수 있는 오디오 스트림 수를 검색합니다. |
| Balance | 오디오 스트림 출력에 대한 스피커 균형을 설정하거나 검색합니다. |
| CurrentAudioStream | 활성화된 오디오 스트림의 수를 설정하거나 검색합니다. |
| DefaultAudioLanguage | 디스크에서 기본 오디오 언어를 검색합니다. |
| DefaultAudioLanguageExt | 디스크에서 기본 오디오 언어 확장을 검색합니다. |
| GetAudioLanguage | 지정된 오디오 스트림에서 사용할 수 있는 언어를 나타내는 문자열을 검색합니다. |
| IsAudioStreamEnabled | 현재 타이틀에서 지정된 오디오 스트림을 사용할 수 있는지 여부를 나타내는 값을 검색합니다. |
| 음소거 | 오디오 스트림 출력을 켜거나 끕니다. |
| SelectDefaultAudioLanguage | DVD 탐색기에서 현재 기본 오디오 언어를 설정합니다. |
| 볼륨 | 오디오 볼륨 수준을 설정하거나 검색합니다. |
| 하위 구조 스트림 | |
| CurrentSubpictureStream | 선택한 하위 그림 스트림을 검색합니다. |
| DefaultSubpictureLanguage | 디스크에서 기본 하위 정보 언어를 검색합니다. |
| DefaultSubpictureLanguageExt | 디스크에서 기본 하위 정보 언어 확장을 검색합니다. |
| GetSubpictureLanguage | 지정된 하위 컬렉션 스트림의 언어를 검색합니다. |
| IsSubpictureStreamEnabled | 지정된 하위 그림 스트림이 현재 제목에서 사용하도록 설정되어 있는지 여부를 나타내는 값을 검색합니다. |
| PreferredSubpictureStream | 현재 보기 세션에 대한 사용자의 기본 하위 작업 스트림을 설정하거나 검색합니다. |
| SelectDefaultSubpictureLanguage | DVD 탐색기에서 현재 기본 하위 구성 언어를 설정합니다. |
| SubpictureOn | 현재 하위 작업 상태(켜기 또는 끄기)를 설정하거나 검색합니다. |
| SubpictureStreamsAvailable | 현재 타이틀에서 사용할 수 있는 하위 컬렉션 스트림의 수를 검색합니다. |
| 비디오 사각형 | |
| AspectRatio | 디스크에 작성된 현재 비디오 스트림의 가로 세로 비율을 검색합니다. |
| BackColor | 네이티브 비디오의 가로 세로 비율이 개체의 표시 영역과 같지 않을 때 비디오 사각형 가장자리 주위에 표시되는 막대의 색을 설정하거나 검색합니다. |
| 캡처 | MSWebDVD 개체가 창 없는 모드에 있을 때 비디오 프레임에서 스틸 이미지를 캡처합니다. |
| FullScreenMode | 디스플레이가 전체 화면 모드인지 여부를 나타내는 값을 설정하거나 검색합니다. |
| GetClipVideoRect | 비디오 디스플레이에 대해 정의된 클리핑 사각형을 검색합니다. |
| GetVideoSize | 네이티브 비디오 차원을 검색합니다. |
| SetClipVideoRect | 비디오 디스플레이에서 차지하는 클리핑 사각형을 설정합니다. |
| Zoom | 지정된 화면 좌표 집합을 중심으로 비디오 디스플레이를 확대하거나 축소합니다. |
| 캡션을 | |
| CCActive | 선택 자막의 현재 상태 설정하거나 검색합니다. |
| ColorKey | 선택 자막에 사용되는 색 키를 설정하거나 검색합니다. |
| CurrentCCService | 현재 선택 자막 서비스를 설정하거나 검색합니다. |
| 각도 블록 | |
| AnglesAvailable | 사용 가능한 각도 수를 검색합니다. |
| CurrentAngle | 각도 블록에서 현재 각도를 설정하거나 검색합니다. |
| 가라오케 오디오 | |
| GetKaraokeChannelAssignment | 노래방 채널이 왼쪽 및 오른쪽 스피커에 할당되는 방식을 나타내는 값을 검색합니다. |
| GetKaraokeChannelContent | 지정된 스트림에서 지정된 노래방 채널의 콘텐츠 형식을 나타내는 값을 검색합니다. |
| KaraokeAudioPresentationMode | 보조 가라오케 채널의 오른쪽 왼쪽 스피커 믹스를 설정하거나 검색합니다. |
| 텍스트 문자열 | |
| GetDVDTextLanguageLCID | 지정된 텍스트 문자열 블록에 대한 LCID(로캘 식별자)를 검색합니다. |
| GetDVDTextNumberOfLanguages | 현재 DVD 디렉터리에서 사용할 수 있는 텍스트 언어 수를 검색합니다. |
| GetDVDTextNumberOfStrings | 지정된 언어에 사용할 수 있는 텍스트 문자열 수를 검색합니다. |
| GetDVDTextString | 디스크에서 지정된 텍스트 문자열을 검색합니다. |
| GetDVDTextStringType | 지정된 DVD 텍스트 문자열에 포함된 정보의 유형을 나타내는 값을 검색합니다. |
| GetLangFromLangID | 기본 언어 식별자(ID)가 지정된 경우 사람이 읽을 수 있는 문자열을 검색합니다. |
| 자녀 관리 | |
| AcceptParentalLevelChange | DVD 탐색기에서 새로운 임시 보호자 관리 수준을 수락하거나 거부하도록 지시합니다. |
| GetPlayerParentalCountry | DVD 탐색기에서 설정된 대로 현재 국가/지역을 검색합니다. |
| GetPlayerParentalLevel | DVD 탐색기에서 설정된 보호자 관리 수준을 검색합니다. |
| GetTitleParentalLevels | 지정된 타이틀에 대한 보호자 관리 수준을 검색합니다. |
| NotifyParentalLevelChange | 임시 보호자 관리 수준 명령에 대한 이벤트 처리를 사용하거나 사용하지 않도록 설정합니다. |
| ParentalCountry를 선택합니다. | 후속 재생에 대해 지정된 부모 국가/지역을 설정합니다. |
| ParentalLevel을 선택합니다. | 후속 재생에 대해 지정된 보호자 수준을 설정합니다. |
| 디스크 정보 | |
| CurrentChapter | 현재 재생 중인 챕터의 수를 검색합니다. |
| CurrentDiscSide | DVD의 현재 측면을 검색합니다. |
| CurrentDomain | DVD 탐색기가 있는 DVD 도메인을 검색합니다. |
| CurrentTime | 현재 재생 시간을 검색합니다. |
| CurrentTitle | 현재 재생 중인 타이틀의 수를 검색합니다. |
| CurrentVolume | 현재 루트 디렉터리의 볼륨 번호를 검색합니다. |
| DVDDirectory | 현재 DVD 볼륨의 루트 디렉터리를 검색하거나 설정합니다. |
| DVDTimeCode2bstr | 디스크의 현재 시간을 나타내는 String을 검색합니다. |
| DVDUniqueID | 현재 DVD를 고유하게 식별하는 시스템 생성 번호를 검색합니다. |
| GetNumberOfChapters | 지정된 제목의 챕터 수를 검색합니다. |
| TitlesAvailable | DVD에서 사용할 수 있는 타이틀 수를 검색합니다. |
| TotalTitleTime | 현재 타이틀의 총 재생 시간을 검색합니다. |
| UOPValid | 지정된 사용자 작업이 현재 유효한지 여부를 나타내는 값을 검색합니다. |
| VolumesAvailable | 디스크 집합의 볼륨 수를 지정하는 값을 검색합니다. |
| 개체 초기화 및 제어 | |
| DisableAutoMouseProcessing | 개체의 마우스 처리 기능을 사용하거나 사용하지 않도록 설정합니다. |
| DVDAdm | 애플리케이션 및 사용자 정보를 저장하기 위한 메서드 및 속성을 포함하는 MSDVDAdm 개체에 대한 액세스를 제공합니다. |
| EnableResetOnStop | 필터 그래프가 중지된 상태에서 전환될 때 재생이 다시 시작되는 방법을 결정하는 값을 설정하거나 검색합니다. |
| PlayState | 현재 재생 상태를 검색합니다. |
| ReadyState | MSWebDVD 개체의 ReadyState를 검색합니다. |
| RegionChange | 사용자가 DVD 드라이브와 연결된 지역을 변경할 수 있는 시스템 대화 상자를 표시합니다. |
| 렌더링 | DVD 필터 그래프를 초기화합니다. |
| WindowlessActivation | 창이 있는 모드 또는 창 없는 모드에 대해 디자인 타임에 MSWebDVD 개체를 초기화합니다. |
| 책갈피 | |
| DeleteBookmark | 현재 책갈피를 삭제합니다. |
| RestoreBookmark | 모든 오디오, 비디오 및 하위 정보 설정이 복원된 상태에서 DVD 탐색기를 현재 책갈피에 지정된 대로 DVD의 지점으로 이동합니다. |
| SaveBookmark | 사용자가 나중에 같은 위치로 돌아갈 수 있도록 DVD 탐색기의 현재 디스크 위치와 상태를 디스크에 저장합니다. |
| 커서 및 도구 설명 | |
| CursorType | 현재 커서 형식을 설정하거나 검색합니다. |
| GetDelayTime | MSWebDVD 개체와 연결된 ToolTip의 지연 시간을 검색합니다. |
| SetDelayTime | MSWebDVD 개체와 연결된 ToolTip의 지연 시간을 설정합니다. |
| ShowCursor | DVD 탐색기가 전체 화면 모드일 때 마우스 포인터를 표시합니다. |
| 툴팁 | 마우스 포인터가 MSWebDVD 비디오 사각형 위에 있을 때 표시되는 도구 설명의 텍스트를 설정합니다. |
| ToolTipMaxWidth | MSWebDVD 개체와 연결된 ToolTip의 최대 너비를 설정하거나 검색합니다. |
| GPRM 및 SPRM | |
| GetGPRM | 지정된 일반 매개 변수 레지스터를 검색합니다. |
| GetSPRM | 지정된 시스템 매개 변수 레지스터를 검색합니다. |
| SetGPRM | 지정된 일반 매개 변수 레지스터를 지정된 값으로 설정합니다. |
관련 항목