Metodo IDeviceControl2::SelectSubpictureStream (strmif.h)

  • Articolo

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, FMMediaEngine 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, FMMediaEngine e Audio/Video Capture in Media Foundation anziché DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Il SelectSubpictureStream metodo imposta il flusso di sottopicture da visualizzare.

Sintassi

HRESULT SelectSubpictureStream(
        ULONG   ulSubPicture,
  [in]  DWORD   dwFlags,
  [out] IDvdCmd **ppCmd
);

Parametri

ulSubPicture

Valore che specifica il flusso di sottopicture, che deve essere compreso tra 0 e 31 o 63.

Valore Descrizione
0-31 Il flusso è valido.
63 Il flusso è il flusso fittizio, che significa che è un flusso con velocità ridotta a bit.

[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 IOptionCmd che può essere usato 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.
E_INVALIDARG
 ulSubPicture non è compreso nell'intervallo o non corrisponde a un flusso SP.
E_UNEXPECTED
 Il parametro ulSubPicture è valido, ma lo strumento di navigazione DVD non può impostarlo per un altro motivo.
VFW_E_DVD_OPERATION_INHIBITED
 Il controllo UOP impedisce l'operazione.
VFW_E_DVD_INVALIDDOMAIN
 dominio non valido.
VFW_E_DVD_STREAM_DISABLED
 Il flusso specificato è disabilitato.

Commenti

Nella tabella seguente viene illustrato il nome del comando Allegato J a cui corrisponde il nome del metodo e i domini in cui questo metodo è valido.

Nome comando J allegato Domini validi
Sotto-picture_Stream_Change
  • DVD_DOMAIN_VideoManagerMenu
  • DVD_DOMAIN_VideoTitleSetMenu
  • DVD_DOMAIN_Title
  • DVD_DOMAIN_Stop

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

Vedi anche

Flussi audio e sottopicture

Applicazioni DVD

Codici errore e esito positivo

Interfaccia ICollectionControl2