Método IMFStreamSink::P rocessSample (mfidl.h)

Fornece um exemplo para o fluxo. O coletor de mídia processa o exemplo.

Sintaxe

HRESULT ProcessSample(
  [in] IMFSample *pSample
);

[in] pSample

Ponteiro para a interface IMFSample de um exemplo que contém dados válidos para o fluxo.

O método retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.
MF_E_INVALID_STATE_TRANSITION	O coletor de mídia está no estado errado para receber uma amostra. Por exemplo, o pré-registro foi concluído, mas o relógio de apresentação ainda não foi iniciado.
MF_E_INVALID_TIMESTAMP	O exemplo tem um carimbo de data/hora inválido. Consulte Observações.
MF_E_INVALIDREQUEST	O coletor de mídia está pausado ou interrompido e não pode processar o exemplo.
MF_E_NO_CLOCK	O relógio da apresentação não foi definido. Chame IMFMediasink::SetPresentationClock.
MF_E_NO_SAMPLE_TIMESTAMP	O exemplo não tem um carimbo de data/hora.
MF_E_NOT_INITIALIZED	O coletor de fluxo não foi inicializado.
MF_E_SHUTDOWN	O método Shutdown do coletor de mídia foi chamado.
MF_E_STREAMSINK_REMOVED	Esse fluxo foi removido do coletor de mídia e não é mais válido.

Chame esse método quando o coletor de fluxo enviar um evento MEStreamSinkRequestSample .

Esse método pode retornar MF_E_INVALID_TIMESTAMP por vários motivos, dependendo da implementação do coletor de mídia:

Carimbos de data/hora negativos.
Carimbos de data/hora que saltam para trás (dentro do mesmo fluxo).
Os carimbos de data/hora de um fluxo estão muito distantes dos carimbos de data/hora em outro fluxo dentro do mesmo coletor de mídia (por exemplo, um coletor de arquivos que multiplexa os fluxos).

Nem todo coletor de mídia retorna um código de erro nessas situações.


Cliente mínimo com suporte	Windows Vista [aplicativos da área de trabalho \| Aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2008 [aplicativos da área de trabalho \| Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	mfidl.h
Biblioteca	Mfuuid.lib