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
S_FALSE	O pino rejeita o tipo de mídia.
S_OK	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

Alterações de formato dinâmico

Códigos de erro e êxito

IPin Interface