Metodo IDeviceInfo2::GetCurrentSubpicture (strmif.h)

Articolo
07/28/2023

[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 GetCurrentSubpicture metodo recupera il numero di flussi di sottopicture disponibili nel titolo corrente, il numero di flusso di sottopicture attualmente selezionato e lo stato della sottopicture.

Sintassi

HRESULT GetCurrentSubpicture(
  [out] ULONG *pulStreamsAvailable,
  [out] ULONG *pulCurrentStream,
  [out] BOOL  *pbIsDisabled
);

Parametri

[out] pulStreamsAvailable

Riceve il numero di flussi di sottopicture disponibili.

[out] pulCurrentStream

Riceve il numero del flusso di sottopicture attualmente selezionato.

[out] pbIsDisabled

Riceve un valore booleano che indica se la visualizzazione della sottopictura è disabilitata; TRUE significa che è disabilitato.

Valore restituito

Restituisce uno dei valori HRESULT seguenti.

Codice restituito	Descrizione
S_OK	Operazione completata.
E_POINTER	Argomento non valido.
VFW_E_DVD_INVALIDDOMAIN	Il navigatore DVD non viene inizializzato o meno nel dominio Title.

Commenti

Gli autori di contenuti DVD possono specificare che qualsiasi particolare flusso di sottopicture in un disco viene attivato forzatamente, ovvero che gli autori DVD richiedono che questo flusso visualizzi se il visualizzatore vuole watch o meno. Lo strumento di navigazione DVD è conforme a tutti questi comandi dal disco, il che significa che i flussi attivati forzatamente vengono visualizzati anche se l'applicazione ha disabilitato la visualizzazione della sottopicture con il metodo IDeviceControl2::SetSubpictureState .

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

EC_DVD_SUBPICTURE_STREAM_CHANGE

Codici errore e esito positivo

Interfaccia IInfo2

Condividi tramite