Win32 API 日本語リファレンス
ホーム › Media.DirectShow › DVD_OPTION_FLAG

DVD_OPTION_FLAG

列挙型
📘 Microsoft Learn (日本語) · English
基底型i4

メンバー 19

名前10進16進説明
DVD_ResetOnStop10x1

グラフが停止したときに、DVD Navigator がディスクの先頭に戻るかどうかを指定します。

値 説明
TRUE フィルター グラフが停止すると、DVD Navigator は DVD Stop ドメインに入ります。再生を再開すると、ディスクの先頭から開始します。
FALSE フィルター グラフが停止しても、DVD Navigator は DVD Stop ドメインに入りません。フィルター グラフが再び開始すると、停止した位置から再生が再開されます。

既定値は TRUE です。

フィルター グラフが予期せず停止することがあるため、既定の動作が常に望ましいとは限りません。これは、たとえば画面の解像度が変更された場合、スクリーン セーバーが開始した場合、またはコンピューターがサスペンド モードに入った場合に発生することがあります。このような状況では、ユーザーは通常、同じ位置から再生を再開することを望みます。一般に、アプリケーションは IMediaControl::Run を呼び出す直前に、このフラグを FALSE に設定します。また、再生を停止するという明示的なユーザーの指示に応じて IMediaControl::Stop を呼び出す前に、このフラグを TRUE に設定します。

DVD_NotifyParentalLevelChange20x2

ディスク上の視聴制限レベル (parental level) が変更されたときに、DVD Navigator がアプリケーションに通知するかどうかを指定します。

値 説明
TRUE DVD Navigator が一時的な視聴制限レベル管理コマンドに到達すると、アプリケーションに EC_DVD_PARENTAL_LEVEL_CHANGE イベントを送信します。アプリケーションが IDvdControl2::AcceptParentalLevelChange を呼び出して応答するまで、再生をブロックします。
FALSE DVD Navigator が一時的な視聴制限レベル管理コマンドを検出し、現在の視聴制限レベルが低すぎる場合、Navigator は自動的にそのコマンドを拒否し、ディスクが指定するパスに分岐します。Navigator は、必要なレベルを示す EC_DVD_PARENTAL_LEVEL_CHANGE イベントを送信します。アプリケーションは、再生を停止してパスワード入力ダイアログ ボックスを表示し、再生を再開することで、次回の試行を成功させることができます。

既定値は FALSE です。

DVD_HMSF_TimeCodeEvents30x3

タイムコード情報の形式を指定します。

[DVD_HMSF_TIMECODE](/windows/desktop/api/strmif/ns-strmif-dvd_hmsf_timecode) 構造体。 [DVD_TIMECODE](/windows/desktop/api/strmif/ns-strmif-dvd_timecode) 構造体。
値 説明
TRUE
FALSE

下位互換性のため、既定値は DVD_HMSF_TIMECODE 形式の方が使いやすくなっています。

DVD_AudioDuringFFwdRew40x4

タイムコード情報の形式を指定します。

値 説明
TRUE オーディオ レートがオーディオ デコーダーの最大レートを超えない限り、DVD Navigator は早送りおよび巻き戻し中のオーディオを有効にします。
FALSE Navigator は早送りおよび巻き戻し中のオーディオを無効にします。

既定値は FALSE です。

次のキーを Windows レジストリに作成することでも、早送りおよび巻き戻し中のオーディオを有効にできます。

DWORD HKLM\Software\Microsoft\DVDNavigator\AudioDuringFFwdRev = 1

これは、DVD_AudioDuringFFwdRew フラグを TRUE に設定するのと同じ効果があります。

DVD_EnableNonblockingAPIs50x5
注 Windows XP Service Pack 2 以降が必要です。

このフラグが FALSE の場合、一部の DVD Navigator の関数は、DVD Navigator が操作を完了できるまでブロックします。これが既定の動作です。

このフラグが TRUE の場合、これらの関数はブロックしなくなります。代わりに、DVD Navigator が操作を直ちに完了できない場合、関数は VFW_E_DVD_NONBLOCKING を返します。アプリケーションがこのフラグを TRUE に設定する場合は、VFW_E_DVD_NONBLOCKING エラー コードを処理する必要があります。通常は、関数が成功するか、他のエラー コードを返すまでその関数をポーリングするのが適切な動作です。

このフラグは、少なくとも次のメソッドに影響します。IDvdControl2::ActivateAtPosition、IDvdControl2::SelectAtPosition、IDvdInfo2::GetCurrentLocation、IDvdInfo2::GetState。この一覧は将来拡張される可能性があります。

DVD_CacheSizeInMB60x6
注 Windows Vista 以降が必要です。

DVD Navigator が先読みするデータ量を MB 単位で指定します。このフラグの場合、SetOption の bEnable パラメーターは、ブール値ではなく DWORD 値として解釈されます。

アプリケーションがこのフラグに大きな値 (> 50 MB) を設定すると、ハードウェアによっては、最初のプリフェッチの後に DVD ドライブの回転が停止することがあります。

次のレジストリ キーを作成することでも、キャッシュ サイズを設定できます。HKLM\Software\Microsoft\DVDNavigator\CacheSizeInMB。このレジストリ キーは診断目的のみを想定しています。アプリケーションでは、レジストリ キーではなく DVD_CacheSizeInMB フラグを使用してください。

DVD_EnablePortableBookmarks70x7
注 Windows Vista 以降が必要です。
値 説明
TRUE DVD のブックマークを別のコンピューターで使用できます。Saving and Restoring DvdState Objects を参照してください。
FALSE DVD のブックマークは、作成されたコンピューター上でのみ使用できます。

既定値は FALSE です。

DVD_EnableExtendedCopyProtectErrors80x8
注 Windows Vista 以降が必要です。

このフラグが TRUE の場合、DVD Navigator はコピー防止の失敗に関連する拡張エラー セットをサポートします。これらのエラーは EC_DVD_ERROR イベントを通じて通知され、次のものが含まれます。

  • DVD_PB_STOPPED_CopyProtectOutputNotSupported
  • DVD_PB_STOPPED_CopyProtectOutputFailure
(DVD_PB_STOPPED を参照してください。)

このフラグが FALSE の場合、すべてのコピー防止エラーは、一般的な DVD_PB_STOPPED_CopyProtectFailure エラー コードを使用して報告されます。

下位互換性のため、既定値は FALSE です。

DVD_NotifyPositionChange90x9
注 Windows 7 以降が必要です。

このフラグが TRUE の場合、次のイベントが有効になります。

このフラグの既定値は FALSE です。
DVD_IncreaseOutputControl100xA
注 Windows 7 以降が必要です。

次のフラグのビット単位の OR です。

フラグ 説明
0x01 フォールバックなしで High-Bandwidth Digital Content Protection (HDCP) を強制します。
0x02 Content Scramble System (CSS) による保護がない DVD ディスクに対しても HDCP を強制します。

既定値は 0 です。これらのフラグは特定の目的のために用意されています。推奨値は 0 です。

DVD_EnableStreaming110xB
注 Windows 7 以降が必要です。

ストリーミング モード を有効または無効にします。ストリーミング モードでは、ディスク上の不良ブロックがスキップされます。DVD Navigator は、部分的に訂正されたデータを受け取ります。このモードでは、再生が止まる長い待ち時間ではなく短時間の映像の乱れで済むため、傷が付いたディスクや損傷したディスクを再生する際に、一般的により良い結果が得られます。DVD ドライブがストリーミング I/O をサポートしている必要があります。

既定値は TRUE です。

DVD_EnableESOutput120xC
注 Windows 7 以降が必要です。

DVD Navigator がエレメンタリ ストリームを出力できるようにします。詳細については、DVD Navigator Filter のトピックに記載されているメディア タイプを参照してください。

既定値は FALSE です。

DVD_EnableTitleLength130xD

注 Windows 7 以降が必要です。
[DVD_TitleAttributes](/windows/desktop/api/strmif/ns-strmif-dvd_titleattributes) 構造体。
値 説明
TRUE
FALSE GetTitleAttributes メソッドは、タイトルの長さではなく、タイトルのモード (カラオケ モードまたはその他のモード) を返します。

既定値は FALSE です。

DVD_DisableStillThrottle140xE

このフラグが TRUE の場合、静止画を表示する際に Navigator が通常行う Sleep(1) の呼び出しを無効にします。

下位互換性のため、このフラグの既定値は FALSE ですが、推奨値は TRUE です。

注 Windows 7 以降が必要です。
DVD_EnableLoggingEvents150xF
注 Windows 7 以降が必要です。

このフラグが TRUE の場合、次のイベントが有効になります。

このフラグの既定値は FALSE です。
DVD_MaxReadBurstInKB160x10
注 Windows 7 以降が必要です。

DVD Navigator が 1 回のバーストで先読みするデータの最大量 (キロバイト単位)。このフラグの場合、SetOption の bEnable パラメーターは DWORD 値として解釈されます。

既定値は 128 KB です。

DVD_ReadBurstPeriodInMS170x11
注 Windows 7 以降が必要です。

キャッシュへのバースト読み取りを実行する間隔 (ミリ秒単位)。このフラグの場合、SetOption の bEnable パラメーターは DWORD 値として解釈されます。

既定値は 250 ミリ秒です。

DVD_RestartDisc180x12
DVD_EnableCC190x13

公式ドキュメント

[このページに関連する機能である DirectShow は、レガシー機能です。この機能は MediaPlayer、IMFMediaEngine、および Audio/Video Capture in Media Foundation に置き換えられています。これらの機能は Windows 10 および Windows 11 向けに最適化されています。Microsoft は、可能な場合は新しいコードで DirectShow ではなく MediaPlayer、IMFMediaEngine、Audio/Video Capture in Media Foundation を使用することを強く推奨します。また、レガシー API を使用している既存のコードについても、可能であれば新しい API を使用するように書き換えることを推奨します。]

DVD_OPTION_FLAG 列挙型は、DVD Navigator Filter の動作を制御するフラグを定義します。これらのフラグを設定するには、IDvdControl2::SetOption を呼び出します。

解説(Remarks)

次の表に、ブール型フラグの既定値を示します。

フラグ 既定値
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
出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での定義

列挙メンバーの定義。HSP タブは #define global(値は16進)。

typedef enum DVD_OPTION_FLAG : int {
    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;
public enum DVD_OPTION_FLAG : int
{
    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,
}
Public Enum DVD_OPTION_FLAG As Integer
    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
End Enum
import enum

class DVD_OPTION_FLAG(enum.IntEnum):
    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
pub const DVD_ResetOnStop: i32 = 1;
pub const DVD_NotifyParentalLevelChange: i32 = 2;
pub const DVD_HMSF_TimeCodeEvents: i32 = 3;
pub const DVD_AudioDuringFFwdRew: i32 = 4;
pub const DVD_EnableNonblockingAPIs: i32 = 5;
pub const DVD_CacheSizeInMB: i32 = 6;
pub const DVD_EnablePortableBookmarks: i32 = 7;
pub const DVD_EnableExtendedCopyProtectErrors: i32 = 8;
pub const DVD_NotifyPositionChange: i32 = 9;
pub const DVD_IncreaseOutputControl: i32 = 10;
pub const DVD_EnableStreaming: i32 = 11;
pub const DVD_EnableESOutput: i32 = 12;
pub const DVD_EnableTitleLength: i32 = 13;
pub const DVD_DisableStillThrottle: i32 = 14;
pub const DVD_EnableLoggingEvents: i32 = 15;
pub const DVD_MaxReadBurstInKB: i32 = 16;
pub const DVD_ReadBurstPeriodInMS: i32 = 17;
pub const DVD_RestartDisc: i32 = 18;
pub const DVD_EnableCC: i32 = 19;
// DVD_OPTION_FLAG
const (
	DVD_ResetOnStop int32 = 1
	DVD_NotifyParentalLevelChange int32 = 2
	DVD_HMSF_TimeCodeEvents int32 = 3
	DVD_AudioDuringFFwdRew int32 = 4
	DVD_EnableNonblockingAPIs int32 = 5
	DVD_CacheSizeInMB int32 = 6
	DVD_EnablePortableBookmarks int32 = 7
	DVD_EnableExtendedCopyProtectErrors int32 = 8
	DVD_NotifyPositionChange int32 = 9
	DVD_IncreaseOutputControl int32 = 10
	DVD_EnableStreaming int32 = 11
	DVD_EnableESOutput int32 = 12
	DVD_EnableTitleLength int32 = 13
	DVD_DisableStillThrottle int32 = 14
	DVD_EnableLoggingEvents int32 = 15
	DVD_MaxReadBurstInKB int32 = 16
	DVD_ReadBurstPeriodInMS int32 = 17
	DVD_RestartDisc int32 = 18
	DVD_EnableCC int32 = 19
)
const
  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
pub const DVD_ResetOnStop: i32 = 1;
pub const DVD_NotifyParentalLevelChange: i32 = 2;
pub const DVD_HMSF_TimeCodeEvents: i32 = 3;
pub const DVD_AudioDuringFFwdRew: i32 = 4;
pub const DVD_EnableNonblockingAPIs: i32 = 5;
pub const DVD_CacheSizeInMB: i32 = 6;
pub const DVD_EnablePortableBookmarks: i32 = 7;
pub const DVD_EnableExtendedCopyProtectErrors: i32 = 8;
pub const DVD_NotifyPositionChange: i32 = 9;
pub const DVD_IncreaseOutputControl: i32 = 10;
pub const DVD_EnableStreaming: i32 = 11;
pub const DVD_EnableESOutput: i32 = 12;
pub const DVD_EnableTitleLength: i32 = 13;
pub const DVD_DisableStillThrottle: i32 = 14;
pub const DVD_EnableLoggingEvents: i32 = 15;
pub const DVD_MaxReadBurstInKB: i32 = 16;
pub const DVD_ReadBurstPeriodInMS: i32 = 17;
pub const DVD_RestartDisc: i32 = 18;
pub const DVD_EnableCC: i32 = 19;
const
  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
enum DVD_OPTION_FLAG : int {
    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,
}
#define global DVD_ResetOnStop                     0x1
#define global DVD_NotifyParentalLevelChange       0x2
#define global DVD_HMSF_TimeCodeEvents             0x3
#define global DVD_AudioDuringFFwdRew              0x4
#define global DVD_EnableNonblockingAPIs           0x5
#define global DVD_CacheSizeInMB                   0x6
#define global DVD_EnablePortableBookmarks         0x7
#define global DVD_EnableExtendedCopyProtectErrors 0x8
#define global DVD_NotifyPositionChange            0x9
#define global DVD_IncreaseOutputControl           0xA
#define global DVD_EnableStreaming                 0xB
#define global DVD_EnableESOutput                  0xC
#define global DVD_EnableTitleLength               0xD
#define global DVD_DisableStillThrottle            0xE
#define global DVD_EnableLoggingEvents             0xF
#define global DVD_MaxReadBurstInKB                0x10
#define global DVD_ReadBurstPeriodInMS             0x11
#define global DVD_RestartDisc                     0x12
#define global DVD_EnableCC                        0x13