Metodo IConfigurationInfo2::GetSubpictureAttributes (strmif.h)
[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 GetSubpictureAttributes metodo recupera gli attributi del flusso di sottopicture specificato nel titolo o nel menu specificato.
Sintassi
HRESULT GetSubpictureAttributes(
[in] ULONG ulStream,
[out] DVD_SubpictureAttributes *pATR
);
Parametri
[in] ulStream
Numero di indice compreso tra 0 e 31 del flusso dell'argomento secondario alla query. Vedere la sezione Osservazioni.
[out] pATR
Puntatore a una struttura DVD_SubpictureAttributes che riceve gli attributi di sottopicture.
Valore restituito
Restituisce uno dei valori HRESULT seguenti.
| Codice restituito | Descrizione |
|---|---|
|
Operazione completata. |
|
Non sono stati trovati flussi di sottopicture. |
|
Argomento non valido. |
|
L'argomento secondario non ha attributi definiti. |
Commenti
I numeri di indice 0-31 sono validi solo per i titoli. I menu hanno un solo flusso di sottopicture, che deve essere specificato usando una delle costanti nella tabella seguente:
| Valore | Descrizione |
|---|---|
| DVD_STREAM_DATA_CURRENT (0x800) | Per eseguire una query sul flusso di sottopicture attualmente selezionato. |
| DVD_STREAM_DATA_VMGM (0x400) | Per eseguire una query sugli attributi di sottopicture per Gestione video o menu "In alto". |
| DVD_STREAM_DATA_VTSM (0x401) | Per eseguire una query sugli attributi di sottopicture per il menu del set di titoli video attualmente selezionato. |
Questo metodo viene illustrato nell'applicazione DVDSample in CDeviceCore::GetSPAttributes() e CSPLangDlg::GetSPLang.
Requisiti
| 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 |