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.

Código de retorno Descrição
S_OK
Êxito.
E_INVALIDARG
Argumento inválido.
E_NOTIMPL
Não há suporte para o método .
E_POINTER
Argumento de ponteiro NULL.
VFW_E_WRONG_STATE
O grafo de filtro não foi interrompido.

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

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

IMediaSeeking Interface

IMediaSeeking::GetTimeFormat

IMediaSeeking::QueryPreferredFormat