Metodo IPinConnection::D ynamicQueryAccept (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 DynamicQueryAccept metodo esegue una query che indica se il pin può accettare il tipo di supporto specificato mentre il grafico è in esecuzione con la connessione corrente a questo pin.
Sintassi
HRESULT DynamicQueryAccept(
[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 un valore HRESULT . Di seguito sono indicati alcuni valori possibili.
| Codice restituito | Descrizione |
|---|---|
|
Il tipo di supporto è accettabile. |
|
Il tipo di supporto non è accettabile. |
Commenti
Se questo metodo ha esito positivo, il pin può accettare il tipo di supporto nell'esempio successivo o in una chiamata a IPin::ReceiveConnection.
Un'applicazione o un filtro può chiamare questo metodo per determinare se il grafico del filtro deve essere riconfigurato. Se il pin può accettare il tipo di supporto specificato, non è necessario riconfigurare il grafo.
Anche se il metodo IPin::QueryAccept determina anche se un pin può accettare un tipo di formato, non garantisce che il pin possa passare a tale formato durante l'esecuzione del filtro. Se è necessario cambiare i formati durante l'esecuzione del filtro, chiamare DynamicQueryAccept invece.
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 |