Compartilhar via


Método CPullPin.OnError

[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 OnError método será chamado se ocorrer um erro durante o streaming. A classe derivada deve implementar esse método.

Sintaxe

virtual void OnError(
   HRESULT hr
) = 0;

Parâmetros

h

Especifica o valor HRESULT retornado pelo método que falhou.

Retornar valor

Esse método não retorna um valor.

Comentários

O objeto chama esse método sempre que ocorre um erro que interrompe o thread de extração de dados. O filtro pode usar esse método para se recuperar de erros de streaming normalmente. Na maioria dos casos, o erro é retornado do filtro upstream, portanto, o filtro upstream é responsável por reportá-lo ao Gerenciador de Grafo de Filtro. Se o erro ocorrer dentro do método CPullPin::Receive , o filtro deverá enviar um evento EC_ERRORABORT . (Consulte IMediaeventSink::Notify.)

Requisitos

Requisito Valor
parâmetro
Pullpin.h
Biblioteca
Strmbase.lib (builds de varejo);
Strmbasd.lib (builds de depuração)

Confira também

Classe CPullPin