IDvdInfo2::GetSubpictureLanguage-Methode (strmif.h)

Artikel
03/13/2024

[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 GetSubpictureLanguage -Methode ruft die Sprache des angegebenen Teildatenstroms innerhalb des aktuellen Titels ab.

Syntax

HRESULT GetSubpictureLanguage(
  [in]  ULONG ulStream,
  [out] LCID  *pLanguage
);

Parameter

[in] ulStream

Nummer des Teildatenstroms, für den die Sprache abgerufen wird.

[out] pLanguage

Zeiger auf eine LCID, die die Gebietsschemainformationen empfängt. Die Sprachinformationen können dann mithilfe des Win32 MAKELANGID-Makros aus dem LCID extrahiert werden.

Rückgabewert

Gibt einen der folgenden HRESULT-Werte zurück.

Rückgabecode	BESCHREIBUNG
S_OK	Erfolg.
E_INVALIDARG	Ungültiges Argument.
VFW_E_DVD_INVALIDDOMAIN	Der DVD-Navigator wird nicht oder nicht in einer gültigen Domäne initialisiert.

Hinweise

Rufen Sie GetMenuLanguages auf, um die für ein Menü verfügbaren Textsprachen abzurufen. GetSubpictureLanguage legt den Wert, auf den pLanguage verweist, auf 0 fest, wenn der Stream eine unbekannte Sprache enthält. Rufen Sie die Win32 GetLocaleInfo-Funktion wie folgt auf, um einen lesbaren Zeichenfolgennamen aus pLanguage zu erstellen:

C++
LCID Language; hr = pDvdInfo->GetSubpictureLanguage(ulStream, &Language); if (SUCCEEDED(hr)) { int cchSize = GetLocaleInfo(Language, LOCALE_SENGLANGUAGE, 0, 0); TCHAR szString = new TCHAR[cchSize]; if (szString) { GetLocaleInfo(Language, LOCALE_SENGLANGUAGE, szString, cchSize); / ... */ delete [] szString; } }

C++

LCID Language;
hr = pDvdInfo->GetSubpictureLanguage(ulStream, &Language);
if (SUCCEEDED(hr))
{
    int cchSize = GetLocaleInfo(Language, LOCALE_SENGLANGUAGE, 0, 0);
    TCHAR *szString = new TCHAR[cchSize];
    if (szString)
    {
        GetLocaleInfo(Language, LOCALE_SENGLANGUAGE, szString, cchSize);
        /* ... */
        delete [] szString;
    }
}

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

Freigeben über