共用方式為


DVD_OPTION_FLAG列舉 (strmif.h)

[與此頁面 相關的功能 DirectShow 是舊版功能。 它已被 MediaPlayerIMFMediaEngineMedia Foundation 中的音訊/視訊擷取取代。 這些功能已針對 Windows 10 和 Windows 11 進行優化。 Microsoft 強烈建議新程式代碼盡可能使用 MediaPlayerIMFMediaEngine音訊/視訊擷取 ,而不是 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::ActivateAtPositionIHttpControl2::SelectAtPositionIHttpInfo2::GetCurrentLocationIHttpInfo2::GetState。 未來可能會展開此清單。
DVD_CacheSizeInMB
值: 6
注意 需要 Windows Vista 或更新版本。

 



指定 DVD 導覽器事先讀取的數據量,以 MB 為單位。 針對此旗標,SetOptionbEnable 參數會解譯為 DWORD 值,而不是布爾值。

如果應用程式將此旗標設定為大數值 (> 50 MB) ,則視硬體而定,DVD 磁碟驅動器可能會在初始預先擷取之後向下旋轉。

您也可以建立下列登錄機碼來設定快取大小: HKLM\Software\Microsoft\DVDNavigator\CacheSizeInMB。 此登錄機碼僅供診斷之用。 應用程式應該使用 DVD_CacheSizeInMB 旗標,而不是登錄機碼。
DVD_EnablePortableBookmarks
值: 7
注意 需要 Windows Vista 或更新版本。

 

















Description
TRUEDVD 書籤可以在另一部計算機上使用。 請參閱 儲存和還原 DvdState 物件
FALSEDVD 書籤只能在建立 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,則會啟用下列事件:


這個旗標的預設值為 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
FALSEGetTitleAttributes 方法會傳回標題模式 () ,而不是標題長度。

 



預設值為 FALSE
DVD_DisableStillThrottle
值: 14
如果此旗標為 TRUE,則會停用導覽器在顯示時所做的呼叫 Sleep(1)

為了回溯相容性,此旗標的預設值為 FALSE,但建議的值為 TRUE


注意 需要 Windows 7 或更新版本。

 
DVD_EnableLoggingEvents
值: 15
注意 需要 Windows 7 或更新版本。

 



如果此旗標為 TRUE,則會啟用下列事件:


這個旗標的預設值為 FALSE
DVD_MaxReadBurstInKB
值: 16
注意 需要 Windows 7 或更新版本。

 



DVD 導覽器會在單一高載中預先讀取的數據量上限,以 KB 為單位。 針對此旗標,SetOptionbEnable 參數會解譯為 DWORD 值。

預設值為 128 KB。
DVD_ReadBurstPeriodInMS
值: 17
注意 需要 Windows 7 或更新版本。

 



在快取中執行高載讀取的頻率,以毫秒為單位。 針對此旗標,SetOptionbEnable 參數會解譯為 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