Método IPin::QueryAccept (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 QueryAccept método determina se o pino aceita um tipo de mídia especificado.
Sintaxe
HRESULT QueryAccept(
[in] const AM_MEDIA_TYPE *pmt
);
Parâmetros
[in] pmt
Ponteiro para uma estrutura AM_MEDIA_TYPE que especifica o tipo de mídia.
Retornar valor
Retorna um dos seguintes valores:
| Código de retorno | Descrição |
|---|---|
|
O pino rejeita o tipo de mídia. |
|
O pin aceita o tipo de mídia. |
Comentários
Um valor retornado de S_OK indica que o pino aceitará o tipo de mídia, seja no próximo exemplo ou após uma reconexão de pino. A implementação deve levar em conta o estado atual do filtro, incluindo conexões em outros pinos e quaisquer propriedades que possam ser definidas no filtro.
Qualquer outro valor retornado, incluindo S_FALSE, significa que o pino rejeita o tipo de mídia. Portanto, teste para S_OK explicitamente; não use a macro SUCCEEDED .
Se o filtro estiver em execução, um valor retornado de S_OK será ambíguo. O pin pode aceitar uma alteração de formato no próximo exemplo de mídia, sem reconectar; ou talvez seja necessário se reconectar. Se o pin der suporte à interface IPinConnection , chame o método IPinConnection::D ynamicQueryAccept , que testa especificamente se o pin pode aceitar o novo tipo sem se reconectar.
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 |
Confira também
Fluxo de Dados no Grafo de Filtro