Método CTransformFilter.Receive
[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 Receive método recebe um exemplo de mídia, processa-o e fornece um exemplo de saída para o filtro downstream.
Sintaxe
HRESULT Receive(
IMediaSample *pSample
);
Parâmetros
-
pSample
-
Ponteiro para a interface IMediaSample no exemplo de entrada.
Retornar valor
Retorna um valor HRESULT . Os possíveis valores incluem os seguintes:
| Código de retorno | Descrição |
|---|---|
|
O filtro upstream deve parar de enviar amostras. |
|
Êxito. |
Comentários
O pin de entrada do filtro chama esse método quando recebe um exemplo. Esse método chama o método CTransformFilter::InitializeOutputSample , que prepara um novo exemplo de saída. Em seguida, ele chama o método CTransformFilter::Transform , que a classe derivada deve implementar. O método Transform processa os dados de entrada e produz dados de saída.
Se o método Transform retornar S_FALSE, o Receive método descartará este exemplo. No primeiro exemplo descartado, o filtro envia um evento EC_QUALITY_CHANGE para o gerenciador de grafo de filtro. Caso contrário, se o método Transform retornar S_OK, o filtro fornecerá o exemplo de saída. Para fazer isso, ele chama o método IMemInputPin::Receive no pin de entrada downstream.
Requisitos
| Requisito | Valor |
|---|---|
| parâmetro |
|
| Biblioteca |
|