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.

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.

Requisiti

Vedi anche

Applicazioni DVD

Codici di errore e di esito positivo

Interfaccia I AvessiControl2

SelectSubpictureStream