Método IMediaSample::SetTime (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 SetTime método define os horários de fluxo quando este exemplo deve começar e concluir.

Sintaxe

HRESULT SetTime(
  [in] REFERENCE_TIME *pTimeStart,
  [in] REFERENCE_TIME *pTimeEnd
);

Parâmetros

[in] pTimeStart

Ponteiro para uma variável que contém a hora de início do exemplo.

[in] pTimeEnd

Ponteiro para uma variável que contém o tempo de parada do exemplo.

Retornar valor

Retorna S_OK ou valor HRESULT que indica a causa do erro.

Comentários

Ambos os valores de tempo são relativos ao tempo de fluxo. Para obter mais informações, consulte Hora e relógios no DirectShow.

Para invalidar os tempos de fluxo, defina pTimeStart e pTimeEnd como NULL. Isso fará com que o método IMediaSample::GetTime retorne VFW_E_SAMPLE_TIME_NOT_SET.

Para obter mais informações sobre os horários de fluxo, consulte Hora e relógios no DirectShow.

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

Códigos de erro e êxito

IMediaSample Interface