IDvdInfo2::GetDVDTextLanguageInfo-Methode (strmif.h)

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde durch MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation ersetzt. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code nach Möglichkeit MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]

Die GetDVDTextLanguageInfo -Methode ruft Informationen zu den Textzeichenfolgen für eine angegebene Sprache ab. Die -Methode ruft die Anzahl der Zeichenfolgen für diese Sprache, den Gebietsschemabezeichner und den Zeichensatz ab.

Syntax

HRESULT GetDVDTextLanguageInfo(
  [in]  ULONG           ulLangIndex,
  [out] ULONG           *pulNumOfStrings,
  [out] LCID            *pLangCode,
  [out] DVD_TextCharSet *pbCharacterSet
);

Parameter

[in] ulLangIndex

Nullbasierter Index der abzufragenden Sprache. Um die Anzahl der Textzeichenfolgensprachen auf der DVD zu ermitteln, rufen Sie IDvdInfo2::GetDVDTextNumberOfLanguages auf.

[out] pulNumOfStrings

Empfängt die Anzahl von Textzeichenfolgen für die angegebene Sprache.

[out] pLangCode

Empfängt einen Gebietsschemabezeichner (Locale Identifier , LCID), der die Sprache angibt, in der der Text geschrieben wird. Beispielsweise ist die LCID für "en-us" 0x0409.

[out] pbCharacterSet

Empfängt ein Element der DVD_TextCharSet-Enumeration . Der Wert gibt den Zeichensatz der Textzeichenfolge an.

Rückgabewert

Gibt einen der folgenden HRESULT-Werte zurück.

Rückgabecode BESCHREIBUNG
S_OK
Erfolg.
E_INVALIDARG
Diese DVD enthält keine Textzeichenfolgen, oder der ulLangIndex-Parameter ist außerhalb der Grenzen.
E_POINTER
NULL-Zeigerargument.
E_UNEXPECTED
Es ist ein unerwarteter Fehler aufgetreten.

Hinweise

Um eine bestimmte Textzeichenfolge abzurufen, rufen Sie IDvdInfo2::GetDVDTextStringAsUnicode oder IDvdInfo2::GetDVDTextStringAsNative auf.

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

IDvdInfo2-Schnittstelle

Arbeiten mit DVD-Textzeichenfolgen