Condividi tramite


Metodo IPin::QueryAccept (strmif.h)

[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 QueryAccept metodo determina se il pin accetta un tipo di supporto specificato.

Sintassi

HRESULT QueryAccept(
  [in] const AM_MEDIA_TYPE *pmt
);

Parametri

[in] pmt

Puntatore a una struttura AM_MEDIA_TYPE che specifica il tipo di supporto.

Valore restituito

Restituisce uno dei valori seguenti:

Codice restituito Descrizione
S_FALSE
Il pin rifiuta il tipo di supporto.
S_OK
Il pin accetta il tipo di supporto.

Commenti

Un valore restituito di S_OK indica che il pin accetterà il tipo di supporto, nell'esempio successivo o dopo la riconnessione di un pin. L'implementazione deve tenere conto dello stato corrente del filtro, incluse le connessioni su altri pin e tutte le proprietà che possono essere impostate sul filtro.

Qualsiasi altro valore restituito, incluso S_FALSE, significa che il pin rifiuta il tipo di supporto. Pertanto, testare in modo esplicito S_OK; non usare la macro SUCCESSED .

Se il filtro è in esecuzione, un valore restituito di S_OK è ambiguo. Il pin potrebbe accettare una modifica del formato nell'esempio multimediale successivo, senza riconnettersi; o potrebbe essere necessario riconnettersi. Se il pin supporta l'interfaccia IPinConnection , chiamare il metodo IPinConnection::D ynamicQueryAccept , che verifica in particolare se il pin può accettare il nuovo tipo senza riconnettersi.

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

Flusso di dati nel grafico di filtro

Modifiche al formato dinamico

Codici errore e esito positivo

Interfaccia IPin