Metodo ICaptureGraphBuilder::SetOutputFileName (strmif.h)

Articolo
03/02/2024

[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.

Nota L'interfaccia ICaptureGraphBuilder è deprecata. Usare invece ICaptureGraphBuilder2 .

Crea la sezione di rendering del grafico del filtro, che salverà i bit su disco con il nome file specificato.

Sintassi

HRESULT SetOutputFileName(
  [in]  const GUID      *pType,
  [in]  LPCOLESTR       lpstrFile,
  [out] IBaseFilter     **ppf,
  [out] IFileSinkFilter **ppSink
);

Parametri

[in] pType

Puntatore a un GUID che rappresenta il sottotipo multimediale. Deve essere &MEDIASUBTYPE_Avi.

[in] lpstrFile

Puntatore a una stringa di caratteri wide contenente il nome del file di output.

[out] ppf

Indirizzo di un puntatore a un'interfaccia IBaseFilter che rappresenta il filtro multiplexer. Questo metodo incrementa il conteggio dei riferimenti nell'interfaccia IBaseFilter , pertanto è necessario decrementare il conteggio dei riferimenti usando il metodo Release su questo parametro al termine dell'utilizzo del filtro.

[out] ppSink

Indirizzo di un puntatore a un'interfaccia IFileSinkFilter che rappresenta il writer di file. Questo metodo incrementa il conteggio dei riferimenti nell'interfaccia IFileSinkFilter, pertanto è necessario decrementare il conteggio dei riferimenti usando Release al termine dell'uso del filtro.

Valore restituito

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

Codice restituito	Descrizione
E_FAIL	Esito negativo.
E_INVALIDARG	Argomento non valido. Audio-Video Interleaved (AVI) è l'unico formato di output supportato.
E_OUTOFMEMORY	Memoria insufficiente.
E_POINTER	Argomento puntatore NULL.
E_UNEXPECTED	Si è verificato un errore imprevisto.
NOERROR	Operazione completata.
S_OK	L'istanza del filtro multiplexer AVI è stata creata correttamente.

Commenti

Questo metodo inserisce il multiplexer e il writer di file nel grafico del filtro e chiama IFileSinkFilter::SetFileName per impostare il nome del file di output.

È possibile usare il parametro ppf restituito da questo metodo come parametro pfRenderer nelle chiamate a RenderStream.

È possibile usare il parametro pSink da questo metodo in una chiamata a SetFileName per modificare il nome del file impostato da ICaptureGraphBuilder::SetOutputFileName.

Requisiti

Requisito	Valore
Client minimo supportato	Riferimento:_Dshowh
Piattaforma di destinazione	Windows
Intestazione	strmif.h
DLL	Quartz.dll

Vedi anche

Codici di errore e di esito positivo

Interfaccia ICaptureGraphBuilder

Condividi tramite