Método IMediaSeeking::GetAvailable (strmif.h)

  • Artigo

[O recurso associado a esta página, DirectShow, é um recurso herdado. Foi substituído por MediaPlayer, IMFMediaEngine e Audio/Video Capture in 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 Audio/Video Capture in 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 GetAvailable método recupera o intervalo de vezes em que a busca é eficiente.

Sintaxe

HRESULT GetAvailable(
  [out] LONGLONG *pEarliest,
  [out] LONGLONG *pLatest
);

Parâmetros

[out] pEarliest

Ponteiro para uma variável que recebe o tempo mais antigo para uma busca eficiente.

[out] pLatest

Ponteiro para uma variável que recebe a hora mais recente para uma busca eficiente.

Retornar valor

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

Código de retorno Descrição
S_OK
 Êxito.
E_NOTIMPL
 Não há suporte para o método .
E_POINTER
 Argumento de ponteiro NULL.

Comentários

Esse método destina-se principalmente à busca em fluxos de mídia que podem ter latência excessiva, como fluxos sendo enviados por uma rede. Os valores retornados indicam dados armazenados em cache que já chegaram, que podem ser facilmente buscados. Supõe-se que buscar valores além desses parâmetros retornados causará um atraso enquanto o aplicativo aguarda a chegada dos dados.

Todos os valores de tempo são expressos no formato de hora atual. O formato de hora padrão é REFERENCE_TIME unidades (100 nanossegundos). Para alterar os formatos de hora, use o método IMediaSeeking::SetTimeFormat .

Requisitos

   
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