Metodo IAMFilterGraphCallback::UnableToRender (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 UnableToRender metodo viene chiamato da Filter Graph Manager se non riesce a trovare alcuna combinazione di filtri per eseguire il rendering del pin specificato.
Sintassi
HRESULT UnableToRender(
IPin *pPin
);
Parametri
pPin
Specifica l'interfaccia IPin del pin che non è stato possibile eseguire il rendering.
Valore restituito
Se il valore restituito è S_OK, il filtro Graph Manager tenta di eseguire di nuovo il rendering del pin. Per qualsiasi altro valore restituito, inclusi S_FALSE e altri codici di esito positivo, Filter Graph Manager continua a compilare il grafico come normale. In genere rifiuterà il filtro corrente e tenterà di usare un filtro diverso.
Commenti
Filter Graph Manager contiene una sezione critica a livello di grafico mentre chiama questo metodo. Pertanto, il metodo di callback deve evitare di chiamare qualsiasi metodo in Filter Graph Manager o qualsiasi metodo sui filtri che potrebbero modificare lo stato del grafico (ad esempio disconnettere i pin). In questo modo potrebbe causare un deadlock o altri comportamenti imprevisti. Tuttavia, è sicuro eseguire una query sul pin per un'interfaccia o controllare il tipo di supporto preferito del pin. L'uso principale per questo metodo consiste nel registrare un nuovo filtro, ad esempio un decodificatore.
Questo metodo usa la convenzione di chiamata di questa chiamata, anziché __stdcall.
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 |