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
S_OK	Il tipo di supporto è accettabile.
VFW_E_TYPE_NOT_ACCEPTED	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

Vedi anche

Modifiche al formato dinamico

Codici di errore e di esito positivo

Interfaccia IPinConnection