Metodo IDeviceControl2::SetSubpictureState (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 SetSubpictureState metodo attiva o disattiva la visualizzazione dell'argomento secondario.
Sintassi
HRESULT SetSubpictureState(
[in] BOOL bState,
[in] DWORD dwFlags,
[out] IDvdCmd **ppCmd
);
Parametri
[in] bState
Valore booleano che specifica se la visualizzazione dell'argomento secondario è attivata; TRUE imposta la visualizzazione dell'argomento secondario su per la riproduzione successiva.
[in] dwFlags
OR bit per bit di uno o più flag dall'enumerazione DVD_CMD_FLAGS , specificando come sincronizzare il comando.
[out] ppCmd
Riceve un puntatore a un oggetto IItemCmd che può essere utilizzato per sincronizzare i comandi DVD. Il chiamante deve rilasciare l'interfaccia. Questo parametro può essere NULL. Per altre informazioni, vedere Sincronizzazione dei comandi DVD.
Valore restituito
Restituisce uno dei valori seguenti.
| Codice restituito | Descrizione |
|---|---|
|
Operazione completata. |
|
Lo strumento di navigazione DVD si trova nel dominio First Play. |
|
Il controllo UOP impedisce l'operazione. |
Commenti
I flussi di sottopicture vengono in genere usati nei menu per il testo dei pulsanti e talvolta per la grafica dei pulsanti e nella riproduzione video per sottotitoli, crediti o altri elementi grafici sovrapposti. Non confondere le sottopicture con didascalie chiuse; quest'ultimo viene codificato all'interno del flusso video. In generale, questo metodo è destinato a controllare la visualizzazione dell'argomento secondario sul video mentre il filtro Strumento di navigazione DVD sta riproducendo video nel dominio titolo DVD.
Questo metodo corrisponde al secondo parametro del comando "Sub-picture_Stream_Change" allegato J.
La tabella seguente illustra il nome del comando Allegato J a cui corrisponde questo nome di metodo e i domini in cui questo metodo è valido.
| Nome comando J allegato | Domini validi |
| Picture_stream_Change secondario |
|
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 |