DVD_OPTION_FLAG列挙 (strmif.h)
[このページに関連付けられている機能 DirectShow は、従来の機能です。 MediaPlayer、IMFMediaEngine、および Media Foundation のオーディオ/ビデオ キャプチャに置き換わりました。 これらの機能は、Windows 10とWindows 11用に最適化されています。 新しいコードでは、可能であれば、DirectShow ではなく Media Foundation で MediaPlayer、IMFMediaEngine、Audio/Video Capture を使用することを強くお勧めします。 Microsoft は、従来の API を使用する既存のコードを、可能であれば新しい API を使用するように書き直すよう提案しています。]
DVD_OPTION_FLAG列挙は、DVD ナビゲーター フィルターの動作を制御するフラグを定義します。 これらのフラグのいずれかを設定するには、 IDvdControl2::SetOption を呼び出します。
構文
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 Service Pack 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 値として解釈されます。 アプリケーションでこのフラグを大きな値 (> 50 MB) に設定すると、ハードウェアによっては、最初のプリフェッチ後に 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 ナビゲーターが 1 回のバーストで先読みするデータの最大量 (キロバイト単位)。 このフラグの場合、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 |
要件
| 要件 | 値 |
|---|---|
| Header | strmif.h (Dshow.h を含む) |