DVD_OPTION_FLAG列舉 (strmif.h)

[與此頁面 相關的功能 DirectShow 是舊版功能。 它已被 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音訊/視訊擷取取代。 這些功能已針對 Windows 10 和 Windows 11 進行優化。 Microsoft 強烈建議新程式代碼盡可能使用 MediaPlayer、 IMFMediaEngine 和 音訊/視訊擷取 ，而不是 DirectShow。 Microsoft 建議盡可能重寫使用舊版 API 的現有程式代碼，以使用新的 API。]

DVD_OPTION_FLAG列舉定義可控制 DVD 導覽器篩選行為的旗標。 若要設定上述任一旗標，請呼叫 IControl2：：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 導覽器是否回到光碟的開頭。 值 Description TRUE 當篩選圖形停止時，DVD 導覽器會進入 DVD 停止網域。 播放繼續時，它會從光碟的開頭開始。 FALSE 當篩選圖形停止時，DVD 導覽器不會進入 DVD 停止網域。 當篩選圖表再次啟動時，播放會從停止的位置繼續播放。   預設值為 TRUE。 默認行為不一定是想要的，因為篩選圖表可能會意外停止。 例如，如果螢幕解析度變更、螢幕保護程序啟動，或計算機進入暫停模式，就會發生這種情況。 在這些情況下，使用者可能想要從相同的點重新啟動播放。 一般而言，應用程式應該在呼叫 IMediaControl：：Run 之前，立即將此旗標設定為 FALSE。 它應該在呼叫 IMediaControl：：Stop 之前將旗標設定為 TRUE，以響應明確使用者以停止播放。
DVD_NotifyParentalLevelChange 值： 2 指定 DVD 導覽器是否會在磁碟上的家長等級變更時通知應用程式。 值 Description TRUE 如果 DVD 導覽器到達暫時的家長管理層級命令，它會將應用程式傳送 EC_DVD_PARENTAL_LEVEL_CHANGE 事件。 它會封鎖播放，直到應用程式呼叫 IControl2：：AcceptParentalLevelChange 來響應為止。 FALSE 當 DVD 導覽器遇到暫時的家長管理層級命令，且目前的家長層級太低時，Navigator 會自動拒絕該命令和分支至光碟所指定的任何路徑。 Navigator 會傳送指出所需層級 的 EC_DVD_PARENTAL_LEVEL_CHANGE 事件。 應用程式可以停止播放、放置密碼對話框，然後重新啟動播放，以便在下一次嘗試時成功。   預設值 FALSE。
DVD_HMSF_TimeCodeEvents 值： 3 指定 timecode 資訊的格式。 DVD_HMSF_TIMECODE 結構。 DVD_TIMECODE 結構。 值 Description TRUE FALSE   為了回溯相容性，預設值 是DVD_HMSF_TIMECODE 格式更容易使用。
DVD_AudioDuringFFwdRew 值： 4 指定 timecode 資訊的格式。 值 Description TRUE 只要音訊速率未超過音訊譯碼器的最大速率，DVD 導覽器就會在快速轉送和倒轉期間啟用音訊。 FALSE 導覽器會在快速向前和倒轉期間停用音訊。   預設值為 FALSE。 您也可以在 Windows 登錄中建立下列機碼，在快速轉送和倒轉期間啟用音訊： DWORD HKLM\Software\Microsoft\DVDNavigator\AudioDuringFFwdRev = 1 這與將DVD_AudioDuringFFwdRew旗標設定為 TRUE的效果相同。
DVD_EnableNonblockingAPIs 值： 5 注意 需要 Windows XP Service Pack 2 或更新版本。   如果此旗標為 FALSE，特定 DVD 導覽器函式會封鎖，直到 DVD 導覽器可以完成作業為止。 這是預設行為。 如果此旗標為 TRUE，這些函式就不會再封鎖。 相反地，如果 DVD 導覽器無法立即完成作業，函式會 傳回VFW_E_DVD_NONBLOCKING。 如果應用程式將此旗標設定為 TRUE，則必須處理 VFW_E_DVD_NONBLOCKING 錯誤碼。 通常正確的行為是輪詢函式，直到函式成功或傳回一些其他錯誤碼為止。 此旗標至少會影響下列方法： IHttpControl2：：ActivateAtPosition、 IHttpControl2：：SelectAtPosition、 IHttpInfo2：：GetCurrentLocation、 IHttpInfo2：：GetState。 未來可能會展開此清單。
DVD_CacheSizeInMB 值： 6 注意 需要 Windows Vista 或更新版本。   指定 DVD 導覽器事先讀取的數據量，以 MB 為單位。 針對此旗標，SetOption 的 bEnable 參數會解譯為 DWORD 值，而不是布爾值。 如果應用程式將此旗標設定為大數值 (> 50 MB) ，則視硬體而定，DVD 磁碟驅動器可能會在初始預先擷取之後向下旋轉。 您也可以建立下列登錄機碼來設定快取大小： HKLM\Software\Microsoft\DVDNavigator\CacheSizeInMB。 此登錄機碼僅供診斷之用。 應用程式應該使用 DVD_CacheSizeInMB 旗標，而不是登錄機碼。
DVD_EnablePortableBookmarks 值： 7 注意 需要 Windows Vista 或更新版本。   值 Description TRUE DVD 書籤可以在另一部計算機上使用。 請參閱 儲存和還原 DvdState 物件。 FALSE DVD 書籤只能在建立 DVD 書籤的電腦上使用。   預設值為 FALSE。
DVD_EnableExtendedCopyProtectErrors 值： 8 注意 需要 Windows Vista 或更新版本。   如果這個旗標 TRUE，DVD 導覽器支援與複製保護失敗相關的擴充錯誤集。 這些錯誤會透過 EC_DVD_ERROR 事件來傳達，並包含下列各項： DVD_PB_STOPPED_CopyProtectOutputNotSupported DVD_PB_STOPPED_CopyProtectOutputFailure (請參閱 DVD_PB_STOPPED.) 如果此旗標為 FALSE，則會使用一般 DVD_PB_STOPPED_CopyProtectFailure 錯誤碼報告所有複製保護錯誤。 為了回溯相容性，預設值為 FALSE。
DVD_NotifyPositionChange 值： 9 注意 需要 Windows 7 或更新版本。   如果此旗標為 TRUE，則會啟用下列事件： EC_DVD_PROGRAM_CELL_CHANGE EC_DVD_PROGRAM_CHAIN_CHANGE EC_DVD_TITLE_SET_CHANGE 這個旗標的預設值為 FALSE。
DVD_IncreaseOutputControl 值： 10 注意 需要 Windows 7 或更新版本。   下列旗標的位 OR ： 旗標 描述 0x01 (HDCP) 強制執行 High-Bandwidth 數位內容保護，而不需後援。 0x02 即使沒有 Content Scramble System (CSS) 保護的 DVD 光碟，仍會強制執行 HDCP。   預設值為零。 這些旗標適用於目的。 建議值為零。
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 結構。 值 Description TRUE FALSE GetTitleAttributes 方法會傳回標題模式 () ，而不是標題長度。   預設值為 FALSE。
DVD_DisableStillThrottle 值： 14 如果此旗標為 TRUE，則會停用導覽器在顯示時所做的呼叫 Sleep(1) 。 為了回溯相容性，此旗標的預設值為 FALSE，但建議的值為 TRUE。 注意 需要 Windows 7 或更新版本。
DVD_EnableLoggingEvents 值： 15 注意 需要 Windows 7 或更新版本。   如果此旗標為 TRUE，則會啟用下列事件： EC_DVD_BeginNavigationCommands EC_DVD_GPRM_Change EC_DVD_NavigationCommand EC_DVD_SPRM_Change EC_DVD_VOBU_Offset EC_DVD_VOBU_Timestamp 這個旗標的預設值為 FALSE。
DVD_MaxReadBurstInKB 值： 16 注意 需要 Windows 7 或更新版本。   DVD 導覽器會在單一高載中預先讀取的數據量上限，以 KB 為單位。 針對此旗標，SetOption 的 bEnable 參數會解譯為 DWORD 值。 預設值為 128 KB。
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)

另請參閱

DirectShow 列舉型別

IMyControl2：：SetOption