Metodo IGraphConfig::SetFilterFlags (strmif.h)

  • Articolo

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

Il SetFilterFlags metodo imposta le informazioni di configurazione di un filtro.

Sintassi

HRESULT SetFilterFlags(
  [in] IBaseFilter *pFilter,
  [in] DWORD       dwFlags
);

Parametri

[in] pFilter

Puntatore all'interfaccia IBaseFilter di un filtro nel grafico dei filtri.

[in] dwFlags

Valore che specifica i nuovi flag di configurazione. Deve essere uno dei valori seguenti.

Valore Descrizione
Zero Nessun contrassegno impostato.
AM_FILTER_FLAGS_REMOVABLE Il filtro è rimovibile durante una riconnessione dinamica. Per altre informazioni, vedere la sezione Osservazioni.

Valore restituito

Restituisce uno dei valori HRESULT seguenti.

Codice restituito Descrizione
E_POINTER
 Argomento puntatore NULL.
E_INVALIDARG
 Argomento non valido.
S_OK
 Operazione completata.
VFW_E_NOT_IN_GRAPH
 Il filtro non è presente nel grafico.

Commenti

Il flag AM_FILTER_FLAGS_REMOVABLE modifica il comportamento del metodo IGraphConfig::Reconnect . Il metodo Reconnect esegue una riconnessione dinamica tra due pin. Se il chiamante specifica un pin, ma lascia l'altro pin non specificato, Riconnetti cerca upstream o downstream dal pin specificato per trovare una corrispondenza appropriata. Per impostazione predefinita, tuttavia, la ricerca ha esito negativo se raggiunge un filtro aggiunto al grafico tramite il metodo IFilterGraph::AddFilter . Per eseguire l'override di questo comportamento, chiamare SetFilterFlags e impostare il flag AM_FILTER_FLAGS_REMOVABLE sul filtro.

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

Codici di errore e di esito positivo

Interfaccia IGraphConfig