Metodo IDeviceInfo2::GetSubpictureLanguage (strmif.h)

Articolo
03/02/2024

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation. Queste funzionalità sono state ottimizzate per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation invece di DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Il GetSubpictureLanguage metodo recupera la lingua del flusso di sottopicture specificato all'interno del titolo corrente.

Sintassi

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

Parametri

[in] ulStream

Numero del flusso dell'argomento secondario per il quale viene recuperata la lingua.

[out] pLanguage

Puntatore a un LCID che riceve le informazioni sulle impostazioni locali. Le informazioni sulla lingua possono quindi essere estratte dall'LCID usando la macro MAKELANGID Win32.

Valore restituito

Restituisce uno dei valori HRESULT seguenti.

Codice restituito	Descrizione
S_OK	Operazione completata.
E_INVALIDARG	Argomento non valido.
VFW_E_DVD_INVALIDDOMAIN	Lo strumento di navigazione DVD non viene inizializzato o non è incluso in un dominio valido.

Commenti

Per ottenere le lingue di testo disponibili per un menu, chiama GetMenuLanguages. GetSubpictureLanguage imposta il valore a cui punta pLanguage su zero se il flusso contiene una lingua sconosciuta. Chiamare la funzione Win32 GetLocaleInfo come indicato di seguito per creare un nome di stringa leggibile da pLanguage:

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;
    }
}

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	strmif.h (include Dshow.h)
Libreria	Strmiids.lib

Vedi anche

Applicazioni DVD

Codici di errore e di esito positivo

Interfaccia IInfo2

Condividi tramite