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
S_OK	Operazione completata.
VFW_E_DVD_INVALIDDOMAIN	Lo strumento di navigazione DVD si trova nel dominio First Play.
VFW_E_DVD_OPERATION_INHIBITED	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	DVD_DOMAIN_VideoManagerMenu DVD_DOMAIN_VideoTitleSetMenu DVD_DOMAIN_Title DVD_DOMAIN_Stop

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 I AvessiControl2

SelectSubpictureStream