Share via

IDvdControl2::SelectDefaultSubpictureLanguage-Methode (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 SelectDefaultSubpictureLanguage -Methode legt die Standardsprache für Subpicture-Text fest.

Syntax

HRESULT SelectDefaultSubpictureLanguage(
  [in] LCID                    Language,
  [in] DVD_SUBPICTURE_LANG_EXT subpictureExtension
);

Parameter

[in] Language

Gebietsschemabezeichner, der die Standardsprache angibt.

[in] subpictureExtension

DVD_SUBPICTURE_LANG_EXT -Enumeration, die die Standard-Unterpicture-Erweiterung angibt.

Rückgabewert

Gibt einen der folgenden Werte zurück.

Rückgabecode BESCHREIBUNG
S_OK
 Erfolg.
E_INVALIDARG
 Die Sprache ist ungültig.
VFW_E_DVD_INVALIDDOMAIN
 Der DVD-Navigator-Filter befindet sich nicht in einer gültigen Domäne.

Hinweise

Diese Methode wählt die Standardsprache und das Standardformat aus, die für Untergeordnete und Menüs verwendet werden sollen, wenn der Datenträger wiedergegeben wird. Wenn Beispielsweise Language als 0x409 für US-Englisch und subpictureExtension als DVD_SP_EXT_Caption_Big angegeben ist, versucht der DVD Navigator, US-englischen Text im Format "big Untertitel" in Unterpubskriptionen anzuzeigen. Wenn die Standardsprache oder Spracherweiterung nicht auf einem Datenträger gefunden wird, wählt der DVD-Navigator die nächstgelegene Übereinstimmung aus.

Die folgende Tabelle enthält den Namen des Anhangs J-Befehls, dem dieser Methodenname entspricht, und die Domänen, in denen diese Methode gültig ist.

Anhang J Befehlsname Gültige Domänen
Keine DVD_DOMAIN_Stop

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile strmif.h (include Dshow.h)
Bibliothek Strmiids.lib

Weitere Informationen

DVD-Anwendungen

Fehler- und Erfolgscodes

IDvdControl2-Schnittstelle