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 |
|---|---|
|
Êxito. |
|
Argumento inválido. |
|
Não há suporte para o método . |
|
Argumento de ponteiro NULL. |
|
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 |