DVD_OPTION_FLAG 열거형(strmif.h)
[이 페이지와 연결된 기능인 DirectShow는 레거시 기능입니다. MediaPlayer, IMFMediaEngine 및 Media Foundation의 오디오/비디오 캡처로 대체되었습니다. 이러한 기능은 Windows 10 및 Windows 11 최적화되었습니다. 가능한 경우 새 코드가 DirectShow 대신 Media Foundation에서 MediaPlayer, IMFMediaEngine 및 오디오/비디오 캡처를 사용하는 것이 좋습니다. 가능한 경우 레거시 API를 사용하는 기존 코드를 다시 작성하여 새 API를 사용하도록 제안합니다.]
DVD_OPTION_FLAG 열거형은 DVD 탐색기 필터의 동작을 제어하는 플래그를 정의합니다. 이러한 플래그를 설정하려면 IDvdControl2::SetOption을 호출합니다.
Syntax
typedef enum __MIDL___MIDL_itf_strmif_0000_0132_0003 {
DVD_ResetOnStop = 1,
DVD_NotifyParentalLevelChange = 2,
DVD_HMSF_TimeCodeEvents = 3,
DVD_AudioDuringFFwdRew = 4,
DVD_EnableNonblockingAPIs = 5,
DVD_CacheSizeInMB = 6,
DVD_EnablePortableBookmarks = 7,
DVD_EnableExtendedCopyProtectErrors = 8,
DVD_NotifyPositionChange = 9,
DVD_IncreaseOutputControl = 10,
DVD_EnableStreaming = 11,
DVD_EnableESOutput = 12,
DVD_EnableTitleLength = 13,
DVD_DisableStillThrottle = 14,
DVD_EnableLoggingEvents = 15,
DVD_MaxReadBurstInKB = 16,
DVD_ReadBurstPeriodInMS = 17,
DVD_RestartDisc = 18,
DVD_EnableCC = 19
} DVD_OPTION_FLAG;
상수
DVD_ResetOnStop값: 1 그래프가 중지되면 DVD 탐색기가 디스크의 시작 부분에 반환되는지 여부를 지정합니다.
기본값은 TRUE입니다. 필터 그래프가 예기치 않게 중지될 수 있으므로 기본 동작이 항상 바람직하지는 않습니다. 예를 들어 화면 해상도가 변경되거나 화면 보호기가 시작되거나 컴퓨터가 일시 중단 모드로 전환되는 경우 발생할 수 있습니다. 이러한 경우 사용자는 동일한 지점에서 재생을 다시 시작하려고 할 수 있습니다. 일반적으로 애플리케이션은 IMediaControl::Run을 호출하기 직전에 이 플래그를 FALSE로 설정해야 합니다. 재생을 중지하도록 명령하는 명시적 사용자에 대한 응답으로 IMediaControl::Stop을 호출하기 전에 플래그를 TRUE로 설정해야 합니다. |
||||||
DVD_NotifyParentalLevelChange값: 2 디스크에서 보호자 수준이 변경되면 DVD 탐색기가 응용 프로그램에 알릴지 여부를 지정합니다.
기본값 FALSE입니다. |
||||||
DVD_HMSF_TimeCodeEvents값: 3 시간 코드 정보의 형식을 지정합니다. DVD_HMSF_TIMECODE 구조체입니다. DVD_TIMECODE 구조체입니다.
이전 버전과의 호환성을 위해 기본값은 DVD_HMSF_TIMECODE 형식을 사용하는 것이 더 쉽습니다. |
||||||
DVD_AudioDuringFFwdRew값: 4 시간 코드 정보의 형식을 지정합니다.
기본값은 FALSE입니다. Windows 레지스트리에서 다음 키를 만들어 빠르게 전달하고 되감는 동안 오디오를 사용하도록 설정할 수도 있습니다. DWORD HKLM\Software\Microsoft\DVDNavigator\AudioDuringFFwdRev = 1이는 DVD_AudioDuringFFwdRew 플래그를 TRUE로 설정하는 것과 동일한 효과가 있습니다. |
||||||
DVD_EnableNonblockingAPIs값: 5 참고 Windows XP 서비스 팩 2 이상이 필요합니다. 이 플래그가 FALSE이면 DVD 탐색기에서 작업을 완료할 때까지 특정 DVD 탐색기 함수가 차단됩니다. 기본 동작입니다. 이 플래그가 TRUE이면 해당 함수는 더 이상 차단되지 않습니다. 대신 DVD 탐색기가 작업을 즉시 완료할 수 없는 경우 함수는 VFW_E_DVD_NONBLOCKING 반환합니다. 애플리케이션이 이 플래그를 TRUE로 설정하면 VFW_E_DVD_NONBLOCKING 오류 코드를 처리해야 합니다. 일반적으로 올바른 동작은 함수가 성공하거나 다른 오류 코드를 반환할 때까지 함수를 폴링하는 것입니다. 이 플래그는 IDvdControl2::ActivateAtPosition, IDvdControl2::SelectAtPosition, IDvdInfo2::GetCurrentLocation, IDvdInfo2::GetState 메서드에 영향을 줍니다. 이 목록은 나중에 확장될 수 있습니다. |
||||||
DVD_CacheSizeInMB값: 6 참고 Windows Vista 이상이 필요합니다. DVD 탐색기에서 미리 읽는 데이터의 양(MB)을 지정합니다. 이 플래그의 경우 SetOption의 bEnable 매개 변수는 부울이 아닌 DWORD 값으로 해석됩니다. 애플리케이션이 이 플래그를 큰 값(> 50MB)으로 설정하는 경우 하드웨어에 따라 초기 사전 인출 후 DVD 드라이브가 스핀다운할 수 있습니다. 레지스트리 키를 HKLM\Software\Microsoft\DVDNavigator\CacheSizeInMB만들어 캐시 크기를 설정할 수도 있습니다. 이 레지스트리 키는 진단 목적으로만 사용됩니다. 애플리케이션은 레지스트리 키가 아닌 DVD_CacheSizeInMB 플래그를 사용해야 합니다. |
||||||
DVD_EnablePortableBookmarks값: 7 참고 Windows Vista 이상이 필요합니다.
기본값은 FALSE입니다. |
||||||
DVD_EnableExtendedCopyProtectErrors값: 8 참고 Windows Vista 이상이 필요합니다. 이 플래그 가 TRUE이면 DVD 탐색기는 복사 보호 오류와 관련된 확장된 오류 집합을 지원합니다. 이러한 오류는 EC_DVD_ERROR 이벤트를 통해 전달되며 다음을 포함합니다.
( DVD_PB_STOPPED 참조하세요.) 이 플래그가 FALSE이면 모든 복사 보호 오류가 일반 DVD_PB_STOPPED_CopyProtectFailure 오류 코드를 사용하여 보고됩니다. 이전 버전과의 호환성을 위해 기본값은 FALSE입니다. |
||||||
DVD_NotifyPositionChange값: 9 참고 Windows 7 이상이 필요합니다. 이 플래그가 TRUE이면 다음 이벤트가 활성화됩니다. 이 플래그의 기본값은 FALSE입니다. |
||||||
DVD_IncreaseOutputControl값: 10 참고 Windows 7 이상이 필요합니다. 다음 플래그의 비트 OR 입니다.
기본값은 영입니다. 이러한 플래그는 용도로 사용됩니다. 권장 값은 0입니다. |
||||||
DVD_EnableStreaming값: 11 참고 Windows 7 이상이 필요합니다. 스트리밍 모드를 사용하거나 사용하지 않도록 설정합니다. 스트리밍 모드에서는 디스크의 잘못된 블록을 건너뜁습니다. DVD 탐색기는 부분적으로 수정된 데이터를 받습니다. 이 모드는 일반적으로 재생을 차단하는 긴 대기보다 짧은 비디오 손상이 발생하므로 디스크가 긁히거나 손상된 디스크를 재생할 때 더 나은 결과를 생성합니다. DVD 드라이브는 스트리밍 I/O를 지원해야 합니다. 기본값은 TRUE입니다. |
||||||
DVD_EnableESOutput값: 12 참고 Windows 7 이상이 필요합니다. DVD 탐색기가 기본 스트림을 출력할 수 있도록 합니다. 자세한 내용은 DVD 탐색기 필터 항목에 나열된 미디어 유형을 참조하세요. 기본값은 FALSE입니다. |
||||||
DVD_EnableTitleLength값: 13 참고 Windows 7 이상이 필요합니다. DVD_TitleAttributes 구조체입니다.
기본값은 FALSE입니다. |
||||||
DVD_DisableStillThrottle값: 14 이 플래그가 TRUE이면 내비게이터가 스틸을 표시할 Sleep(1) 때 호출을 사용하지 않도록 설정합니다.이전 버전과의 호환성을 위해 이 플래그의 기본값은 FALSE이지만 권장되는 값은 TRUE입니다. 참고 Windows 7 이상이 필요합니다. |
||||||
DVD_EnableLoggingEvents값: 15 참고 Windows 7 이상이 필요합니다. 이 플래그가 TRUE이면 다음 이벤트가 활성화됩니다.
이 플래그의 기본값은 FALSE입니다. |
||||||
DVD_MaxReadBurstInKB값: 16 참고 Windows 7 이상이 필요합니다. DVD 탐색기가 단일 버스트에서 미리 읽을 최대 데이터 양(킬로바이트)입니다. 이 플래그의 경우 SetOption의 bEnable 매개 변수는 DWORD 값으로 해석됩니다. 기본값은 128KB입니다. |
||||||
DVD_ReadBurstPeriodInMS값: 17 참고 Windows 7 이상이 필요합니다. 캐시에 버스트 읽기를 수행하는 빈도(밀리초)입니다. 이 플래그의 경우 SetOption의 bEnable 매개 변수는 DWORD 값으로 해석됩니다. 기본값은 250밀리초입니다. |
||||||
DVD_RestartDisc값: 18 |
||||||
DVD_EnableCC값: 19 |
설명
다음 표에서는 부울 플래그의 기본값을 나열합니다.
| 플래그 | 기본값 |
|---|---|
| DVD_AudioDuringFFwdRew | FALSE |
| DVD_DisableStillThrottle | FALSE |
| DVD_EnableESOutput | FALSE |
| DVD_EnableExtendedCopyProtectErrors | FALSE |
| DVD_EnableLoggingEvents | FALSE |
| DVD_EnableNonblockingAPIs | FALSE |
| DVD_EnableStreaming | TRUE |
| DVD_EnablePortableBookmarks | FALSE |
| DVD_EnableTitleLength | FALSE |
| DVD_HMSF_TimeCodeEvents | FALSE |
| DVD_NotifyParentalLevelChange | FALSE |
| DVD_NotifyPositionChange | FALSE |
| DVD_ResetOnStop | TRUE |
요구 사항
| 요구 사항 | 값 |
|---|---|
| 헤더 | strmif.h(Dshow.h 포함) |
추가 정보
피드백
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요. https://aka.ms/ContentUserFeedback
다음에 대한 사용자 의견 제출 및 보기