Método IMediaSeeking::SetTimeFormat (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 SetTimeFormat método define o formato de tempo para operações de busca subsequentes.

Sintaxe

HRESULT SetTimeFormat(
  [in] const GUID *pFormat
);

Parâmetros

[in] pFormat

Ponteiro para um GUID que especifica o formato de hora. Consulte GUIDs de formato de tempo.

Retornar valor

Retorna um valor HRESULT . Os possíveis valores incluem os seguintes.

Comentários

Esse método especifica as unidades de tempo usadas por outros métodos IMediaSeeking , como IMediaSeeking::GetPositions e IMediaSeeking::SetPositions. Sempre que você chama um desses outros métodos, todos os parâmetros que expressam valores de tempo são fornecidos em unidades do formato de hora atual.

O formato de tempo padrão é REFERENCE_TIME unidades (100 nanossegundos). Outros formatos de tempo incluem quadros, exemplos e bytes. Para determinar se há suporte para um determinado formato, chame o método IMediaSeeking::IsFormatSupported . Se houver suporte para um formato, você poderá alternar para esse formato chamando SetTimeFormat. Apenas um formato de vez em quando está ativo de uma só vez.

Requisitos

Confira também

Códigos de erro e êxito

IMediaSeeking Interface

IMediaSeeking::GetTimeFormat

IMediaSeeking::QueryPreferredFormat