Metodo IGraphConfig::SetFilterFlags (strmif.h)
[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 |
---|---|
|
Argomento puntatore NULL. |
|
Argomento non valido. |
|
Operazione completata. |
|
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 |