Condividi tramite

Metodo IDeviceGraphBuilder::GetDeviceInterface (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 metodo Get MdfInterface recupera le interfacce dal grafico di riproduzione DVD-Video per semplificare lo sviluppo della riproduzione DVD-Video.

Sintassi

HRESULT GetDvdInterface(
  [in]  REFIID riid,
  [out] void   **ppvIF
);

Parametri

[in] riid

ID dell'interfaccia richiesta.

[out] ppvIF

Riceve un puntatore all'interfaccia. L'applicazione deve rilasciare l'interfaccia.

Valore restituito

Restituisce un valore HRESULT . Di seguito sono indicati alcuni valori possibili.

Codice restituito Descrizione
E_INVALIDARG
 Il parametro ppvIF non è valido. Questo parametro non deve essere NULL.
E_NOINTERFACE
 Impossibile restituire l'interfaccia richiesta.
VFW_E_DVD_GRAPHNOTREADY
 Il grafico non è ancora compilato. Vedere la sezione Osservazioni.

Commenti

È possibile usare questo metodo per selezionare e configurare un filtro del renderer video prima di compilare il grafico del filtro per la riproduzione DVD. Sono disponibili le interfacce seguenti:

Se si chiama Get MdfInterface per ottenere una di queste interfacce prima di compilare il grafico del filtro, il generatore di grafici DVD crea il renderer video appropriato. Questo renderer verrà usato in un secondo momento quando si compila il grafico. Dopo aver selezionato il renderer video, non è più possibile recuperare le interfacce per gli altri renderer video. Il metodo Get MdfInterface restituirà E_NOINTERFACE.

Prima che il grafico di riproduzione DVD venga compilato, se si richiedono interfacce non presenti nell'elenco precedente, il metodo restituisce VFW_E_DVD_GRAPHNOTREADY. Per compilare il grafico DVD, chiamare IDeviceGraphBuilder::RenderVideoVolume. Dopo aver compilato il grafico, è possibile usare GetDeviceInterface per recuperare alcune interfacce aggiuntive:

  • INameControl (deprecato), I MdfControl2, IInfo (deprecato) e IInfo2 per controllare la riproduzione DVD.
  • IVideoWindow, IBasicVideo e IBasicVideo2 per controllare le impostazioni video, solo in modalità finestra.
  • IBasicAudio per controllare le impostazioni audio.
  • IAMLine21Decoder per controllare la visualizzazione di didascalia chiusa.
  • IMixerPinConfig e IMixerPinConfig2 per configurare il primo pin di input del filtro Overlay Mixer, che fornisce il flusso video primario. Per ottenere questa interfaccia per gli altri pin nel mixer di sovrapposizione, enumerare i pin del filtro ed eseguirne una query direttamente. Le nuove applicazioni devono evitare di usare il filtro Overlay Mixer.
Per ottenere altre interfacce, chiamare IDeviceGraphBuilder::GetFiltergraph. Eseguire una query sull'interfaccia IGraphBuilder restituita o usare EnumFilters per enumerare i filtri.

Requisiti

   
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione strmif.h (include Dshow.h)
Libreria Strmiids.lib

Vedi anche

Applicazioni DVD

Codici errore e esito positivo

Interfaccia ICreaGraphBuilder