Metodo IGraphConfig::SetFilterFlags (strmif.h)

Articolo
03/05/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.

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

Condividi tramite