Metodo IDeviceGraphBuilder::RenderVideoVolume (strmif.h)

Articolo
03/05/2024

[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 RenderDvdVideoVolume metodo completa la compilazione di un grafico di filtro in base alle specifiche utente per la riproduzione di un volume DVD-Video.

Sintassi

HRESULT RenderDvdVideoVolume(
  [in]  LPCWSTR             lpcwszPathName,
  [in]  DWORD               dwFlags,
  [out] AM_DVD_RENDERSTATUS *pStatus
);

Parametri

[in] lpcwszPathName

Puntatore al percorso del volume DVD-Video da riprodurre. Può essere NULL.

[in] dwFlags

OR bit per bit dei flag dall'enumerazione AM_DVD_GRAPH_FLAGS , specificando come compilare il grafico di riproduzione DVD.

[out] pStatus

Puntatore a una struttura AM_DVD_RENDERSTATUS . Quando il metodo restituisce, la struttura indica eventuali errori di rendering.

Valore restituito

Restituisce un valore HRESULT che dipende dall'implementazione dell'interfaccia. I valori restituiti dell'implementazione di DirectShow includono quanto segue:

Codice restituito	Descrizione
E_INVALIDARG	Il parametro dwFlags specifica le opzioni in conflitto.
S_FALSE	Il metodo ha avuto esito parziale. Per scoprire quali errori si sono verificati, esaminare il parametro pStatus .
S_OK	Il metodo ha avuto esito positivo e tutti i flussi sono stati sottoposti a rendering.
VFW_E_DVD_DECNOTENOUGH	Impossibile eseguire il rendering di uno o più flussi. Se è stato specificato il flag AM_DVD_HWDEC_ONLY o AM_DVD_SWDEC_ONLY nel parametro dwFlags , provare a chiamare nuovamente il metodo con il flag AM_DVD_HWDEC_PREFER o AM_DVD_SWDEC_PREFER.
VFW_E_DVD_NON_EVR_RENDERER_IN_FILTER_GRAPH	Il grafico del filtro contiene già un renderer video. Il metodo restituisce questo codice di errore se si specifica il flag AM_DVD_EVR_ONLY nel parametro dwFlags , ma il grafico contiene già un renderer video diverso dal filtro VmR (Enhanced Video Renderer).
VFW_E_DVD_RENDERFAIL	Si è verificato un errore durante la compilazione del grafico. Ad esempio, il generatore di grafici DVD non è riuscito a creare un filtro obbligatorio o non è stato possibile eseguire il rendering di uno dei flussi.
VFW_E_DVD_TOO_MANY_RENDERERS_IN_FILTER_GRAPH	Il grafico del filtro contiene più di un renderer video.

Commenti

La struttura AM_DVD_RENDERSTATUS riflette i codici di errore per questo metodo. I motivi per questo metodo che restituiscono S_FALSE includono quanto segue:

Il grafico è stato completamente costruito, ma uno dei seguenti è vero.
- La combinazione di sovrapposizioni non funziona: l'applicazione non ha impostato il flag di AM_DVD_NOVPE e il flusso video non è stato possibile inserire il mixer di sovrapposizione. In questo caso, se il video viene decodificato nel software l'applicazione avrà informazioni sufficienti per informare l'utente che il video non sarà visibile. Il video decodificato hardware sarà visibile solo su una TV connessa alla porta out NTSC del decodificatore video hardware.
- Il decodificatore video non produce dati di riga 21. L'applicazione può visualizzare un messaggio di avviso o informativo che la didascalia chiusa non è disponibile a causa del decodificatore.
- Nessun percorso del volume specificato e lo strumento di navigazione DVD non ha individuato alcun volume DVD-Video da riprodurre. L'applicazione può chiedere all'utente di inserire un disco DVD-Video se non è disponibile nell'unità quando viene avviata la riproduzione.
Alcuni flussi non sono stati sottoposti a rendering. L'applicazione può indicare all'utente che alcuni flussi non possono essere riprodotti.

Questo metodo compila il grafico senza alcuna conoscenza del file o del volume di DVD-Video da riprodurre. Il generatore di grafici DVD-Video compila il grafico anche se lpcwszPathName è NULL o se il filtro navigatore DVD non trova un volume predefinito DVD-Video da riprodurre.

Requisiti

Requisito	Valore
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

Condividi tramite