Freigeben über

DVD_OPTION_FLAG-Enumeration (strmif.h)

  • Artikel

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde von MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation abgelöst. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code mediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet, wenn möglich. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, so umgeschrieben wird, dass nach Möglichkeit die neuen APIs verwendet werden.]

Die DVD_OPTION_FLAG-Enumeration definiert Flags, die das Verhalten des DVD-Navigatorfilters steuern. Um eines dieser Flags festzulegen, rufen Sie IDvdControl2::SetOption auf.

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;

Konstanten

 
DVD_ResetOnStop
Wert: 1
Gibt an, ob der DVD-Navigator zum Anfang des Datenträgers zurückkehrt, wenn das Diagramm beendet wird.















WertBeschreibung
TRUEDer DVD-Navigator wechselt in die DVD-Stop-Domäne, wenn das Filterdiagramm beendet wird. Wenn die Wiedergabe fortgesetzt wird, beginnt sie am Anfang des Datenträgers.
FALSEDer DVD-Navigator wechselt nicht in die DVD-Stop-Domäne, wenn das Filterdiagramm beendet wird. Wenn das Filterdiagramm erneut gestartet wird, wird die Wiedergabe an dem Punkt fortgesetzt, an dem es beendet wurde.

 



Der Standardwert ist TRUE.

Das Standardverhalten ist nicht immer wünschenswert, da das Filterdiagramm möglicherweise unerwartet beendet wird. Dies kann beispielsweise der Fall sein, wenn sich die Bildschirmauflösung ändert, ein Bildschirmschoner gestartet wird oder der Computer in den angehaltenen Modus wechselt. In diesen Situationen möchte der Benutzer wahrscheinlich, dass die Wiedergabe von demselben Punkt aus neu gestartet wird. In der Regel sollte die Anwendung dieses Flag unmittelbar vor dem Aufruf von IMediaControl::Run auf FALSE festlegen. Es sollte das Flag auf TRUE festlegen, bevor IMediaControl::Stop aufgerufen wird, um einen expliziten Benutzer zu befehlen, um die Wiedergabe zu beenden.
DVD_NotifyParentalLevelChange
Wert: 2
Gibt an, ob der DVD-Navigator die Anwendung benachrichtigt, wenn sich die Elterebene auf dem Datenträger ändert.















WertBeschreibung
TRUEWenn der DVD-Navigator einen temporären Befehl für die elterliche Verwaltung erreicht, sendet er der Anwendung ein EC_DVD_PARENTAL_LEVEL_CHANGE-Ereignis . Die Wiedergabe wird blockiert, bis die Anwendung durch Aufrufen von IDvdControl2::AcceptParentalLevelChange antwortet.
FALSEWenn der DVD-Navigator auf einen temporären Befehl der Elterverwaltungsebene stößt und die aktuelle Elterebene zu niedrig ist, lehnt der Navigator den Befehl automatisch ab und verzweigt den Pfad, den der Datenträger angibt. Der Navigator sendet ein EC_DVD_PARENTAL_LEVEL_CHANGE-Ereignis , das die erforderliche Ebene angibt. Die Anwendung kann die Wiedergabe beenden, ein Kennwortdialogfeld einrichten und die Wiedergabe neu starten, damit sie beim nächsten Versuch erfolgreich ausgeführt werden kann.

 



Der Standardwert FALSE.
DVD_HMSF_TimeCodeEvents
Wert: 3
Gibt das Format für Timecodeinformationen an.









DVD_HMSF_TIMECODE Struktur.



DVD_TIMECODE-Struktur .

WertBeschreibung
TRUE
FALSE

 



Aus Gründen der Abwärtskompatibilität ist der Standardwert DVD_HMSF_TIMECODE Format einfacher zu verwenden ist.
DVD_AudioDuringFFwdRew
Wert: 4
Gibt das Format für Timecodeinformationen an.















WertBeschreibung
TRUEDer DVD-Navigator ermöglicht Audio während des schnellen Vor- und Rückspulens, solange die Audiorate die maximale Rate des Audiodecoders nicht überschreitet.
FALSEDer Navigator deaktiviert Audio während des schnellen Vor- und Rückspulens.

 



Der Standardwert ist FALSE.

Sie können audio auch während des schnellen Vor- und Zurückspulens aktivieren, indem Sie den folgenden Schlüssel in der Windows-Registrierung erstellen:

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

Dies hat die gleiche Auswirkung wie das Festlegen des DVD_AudioDuringFFwdRew Flags auf TRUE.
DVD_EnableNonblockingAPIs
Wert: 5
Hinweis Erfordert Windows XP Service Pack 2 oder höher.

 



Wenn dieses Flag FALSE ist, werden bestimmte DVD Navigator-Funktionen blockiert, bis der DVD-Navigator den Vorgang abschließen kann. Dies ist das Standardverhalten.

Wenn dieses Flag TRUE ist, werden diese Funktionen nicht mehr blockiert. Wenn der DVD-Navigator den Vorgang nicht sofort abschließen kann, gibt die Funktion stattdessen VFW_E_DVD_NONBLOCKING zurück. Wenn die Anwendung dieses Flag auf TRUE festlegt, muss sie den VFW_E_DVD_NONBLOCKING Fehlercode verarbeiten. Normalerweise besteht das richtige Verhalten darin, die Funktion abzufragen, bis die Funktion erfolgreich ist oder einen anderen Fehlercode zurückgibt.

Dieses Flag wirkt sich mindestens auf die folgenden Methoden aus: IDvdControl2::ActivateAtPosition, IDvdControl2::SelectAtPosition, IDvdInfo2::GetCurrentLocation, IDvdInfo2::GetState. Diese Liste kann in Zukunft erweitert werden.
DVD_CacheSizeInMB
Wert: 6
Hinweis Erfordert Windows Vista oder höher.

 



Gibt an, wie viele Daten der DVD-Navigator im Voraus in MB liest. Für dieses Flag wird der bEnable-Parameter von SetOption als DWORD-Wert und nicht als boolescher Wert interpretiert.

Wenn die Anwendung dieses Flag auf einen großen Wert (> 50 MB) festlegt, kann das DVD-Laufwerk nach dem anfänglichen Vorababruf abhängig von der Hardware heruntergefahren werden.

Sie können die Cachegröße auch festlegen, indem Sie den folgenden Registrierungsschlüssel erstellen: HKLM\Software\Microsoft\DVDNavigator\CacheSizeInMB. Dieser Registrierungsschlüssel ist nur für Diagnosezwecke vorgesehen. Anwendungen sollten das flag DVD_CacheSizeInMB und nicht den Registrierungsschlüssel verwenden.
DVD_EnablePortableBookmarks
Wert: 7
Hinweis Erfordert Windows Vista oder höher.

 

















WertBeschreibung
TRUEDVD-Lesezeichen können auf einem anderen Computer verwendet werden. Weitere Informationen finden Sie unter Speichern und Wiederherstellen von DvdState-Objekten.
FALSEDVD-Lesezeichen können nur auf dem Computer verwendet werden, auf dem sie erstellt wurden.

 



Der Standardwert ist FALSE.
DVD_EnableExtendedCopyProtectErrors
Wert: 8
Hinweis Erfordert Windows Vista oder höher.

 



Wenn dieses Flag TRUE ist, unterstützt der DVD-Navigator einen erweiterten Satz von Fehlern im Zusammenhang mit Kopierschutzfehlern. Diese Fehler werden über das EC_DVD_ERROR-Ereignis übermittelt und umfassen Folgendes:


  • DVD_PB_STOPPED_CopyProtectOutputNotSupported

  • DVD_PB_STOPPED_CopyProtectOutputFailure


(Siehe DVD_PB_STOPPED.)

Wenn dieses Flag FALSE ist, werden alle Kopierschutzfehler mithilfe des allgemeinen DVD_PB_STOPPED_CopyProtectFailure Fehlercode gemeldet.

Aus Gründen der Abwärtskompatibilität ist der Standardwert FALSE.
DVD_NotifyPositionChange
Wert: 9
Hinweis Erfordert Windows 7 oder höher.

 



Wenn dieses Flag TRUE ist, werden die folgenden Ereignisse aktiviert:


Der Standardwert für dieses Flag ist FALSE.
DVD_IncreaseOutputControl
Wert: 10
Hinweis Erfordert Windows 7 oder höher.

 



Bitweise OR der folgenden Flags:















FlagBeschreibung
0x01Erzwingen Sie High-Bandwidth Digital Content Protection (HDCP) ohne Fallback.
0x02Erzwingen Sie HDCP auch für DVD-Datenträger ohne CSS-Schutz (Content Scramble System).

 



Der Standardwert ist 0 (null). Diese Flags sind für Zwecke vorgesehen. Der empfohlene Wert ist 0.
DVD_EnableStreaming
Wert: 11
Hinweis Erfordert Windows 7 oder höher.

 



Aktiviert oder deaktiviert den Streamingmodus. Im Streamingmodus werden fehlerhafte Blöcke auf dem Datenträger übersprungen. Der DVD Navigator empfängt teilweise korrigierte Daten. Dieser Modus erzeugt in der Regel bessere Ergebnisse bei der Wiedergabe von zerkratzten oder beschädigten Datenträgern, da dies zu einer kurzen Videobeschädigung führt, anstatt zu langen Wartezeiten, die die Wiedergabe blockieren. Das DVD-Laufwerk muss Streaming-E/A unterstützen.

Der Standardwert ist TRUE.
DVD_EnableESOutput
Wert: 12
Hinweis Erfordert Windows 7 oder höher.

 



Ermöglicht dem DVD-Navigator die Ausgabe elementarer Streams. Weitere Informationen finden Sie unter den Medientypen, die im Thema DVD Navigator Filter aufgeführt sind.

Der Standardwert ist FALSE.
DVD_EnableTitleLength
Wert: 13



Hinweis Erfordert Windows 7 oder höher.

 











DVD_TitleAttributes Struktur.





WertBeschreibung
TRUE
FALSEDie GetTitleAttributes-Methode gibt den Titelmodus (Karaokemodus oder anderer Modus) und nicht die Titellänge zurück.

 



Der Standardwert ist FALSE.
DVD_DisableStillThrottle
Wert: 14
Wenn dieses Flag TRUE ist, deaktiviert es einen Aufruf Sleep(1) , den der Navigator andernfalls beim Anzeigen von Stills ausgibt.

Aus Gründen der Abwärtskompatibilität ist der Standardwert für dieses Flag FALSE, aber der empfohlene Wert ist TRUE.


Hinweis Erfordert Windows 7 oder höher.

 
DVD_EnableLoggingEvents
Wert: 15
Hinweis Erfordert Windows 7 oder höher.

 



Wenn dieses Flag TRUE ist, werden die folgenden Ereignisse aktiviert:


Der Standardwert für dieses Flag ist FALSE.
DVD_MaxReadBurstInKB
Wert: 16
Hinweis Erfordert Windows 7 oder höher.

 



Die maximale Datenmenge, die der DVD-Navigator in einem einzelnen Burst in Kilobyte vorliest. Für dieses Flag wird der bEnable-Parameter von SetOption als DWORD-Wert interpretiert.

Der Standardwert ist 128 KB.
DVD_ReadBurstPeriodInMS
Wert: 17
Hinweis Erfordert Windows 7 oder höher.

 



Wie oft Burstlesevorgänge in Millisekunden in den Cache ausgeführt werden sollen. Für dieses Flag wird der bEnable-Parameter von SetOption als DWORD-Wert interpretiert.

Der Standardwert ist 250 Millisekunden.
DVD_RestartDisc
Wert: 18
DVD_EnableCC
Wert: 19

Hinweise

In der folgenden Tabelle sind die Standardwerte für die booleschen Flags aufgeführt.

Flag Standardwert
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

Anforderungen

Anforderung Wert
Header strmif.h (include Dshow.h)

Weitere Informationen

DirectShow Enumerated Types

IDvdControl2::SetOption