Método IAMFilterGraphCallback::UnableToRender (strmif.h)
[O recurso associado a esta página, DirectShow, é um recurso herdado. Ele foi substituído por MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo na Media Foundation. Esses recursos foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo no Media Foundation em vez de DirectShow, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]
O UnableToRender método será chamado pelo Gerenciador do Grafo de Filtro se não encontrar nenhuma combinação de filtros para renderizar o pino especificado.
Sintaxe
HRESULT UnableToRender(
IPin *pPin
);
Parâmetros
pPin
Especifica a interface IPin do pino que não pôde ser renderizado.
Retornar valor
Se o valor retornado for S_OK, esse Gerenciador de Grafo de Filtro tentará renderizar o pino novamente. Para qualquer outro valor retornado, incluindo S_FALSE e outros códigos de êxito, o Gerenciador de Grafo de Filtro continua a criar o grafo normalmente. Normalmente, ele rejeitará o filtro atual e tentará usar um filtro diferente.
Comentários
O Gerenciador de Grafo de Filtro contém uma seção crítica em todo o grafo enquanto chama esse método. Portanto, o método de retorno de chamada deve evitar chamar quaisquer métodos no Gerenciador de Grafo de Filtro ou quaisquer métodos em filtros que possam alterar o estado do grafo (como a desconexão de pinos). Isso pode causar um deadlock ou outros comportamentos inesperados. No entanto, é seguro consultar o pino para uma interface ou marcar o tipo de mídia preferencial do pino. O main usar para esse método seria registrar um novo filtro, como um decodificador.
Esse método usa a convenção de chamada thiscall, em vez de __stdcall.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | strmif.h (inclua Dshow.h) |
| Biblioteca | Strmiids.lib |