Compartilhar via


Método IMFSeekInfo::GetNearestKeyFrames (mfidl.h)

Para uma posição de busca específica, obtém os dois quadros-chave mais próximos.

Sintaxe

HRESULT GetNearestKeyFrames(
  [in]  const GUID        *pguidTimeFormat,
  [in]  const PROPVARIANT *pvarStartPosition,
  [out] PROPVARIANT       *pvarPreviousKeyFrame,
  [out] PROPVARIANT       *pvarNextKeyFrame
);

Parâmetros

[in] pguidTimeFormat

Um ponteiro para um GUID que especifica o formato de hora. O formato de hora define as unidades para os outros parâmetros desse método. Se o valor for GUID_NULL, o formato de hora será unidades de 100 nanossegundos. Algumas fontes de mídia podem dar suporte a GUIDs de formato de tempo adicionais.

[in] pvarStartPosition

A posição de busca. As unidades para esse parâmetro são especificadas por pguidTimeFormat.

[out] pvarPreviousKeyFrame

Recebe a posição do quadro chave mais próximo que aparece antes de pvarStartPosition. As unidades para esse parâmetro são especificadas por pguidTimeFormat.

[out] pvarNextKeyFrame

Recebe a posição do quadro chave mais próximo que aparece mais tarde do que pvarStartPosition. As unidades para esse parâmetro são especificadas por pguidTimeFormat.

Valor retornado

Esse método pode retornar um desses valores.

Código de retorno Descrição
S_OK
O método foi bem-sucedido.
MF_E_UNSUPPORTED_TIME_FORMAT
Não há suporte para o formato de hora especificado em pguidTimeFormat .

Comentários

Se um aplicativo busca um quadro não chave, o decodificador deve iniciar a decodificação do quadro-chave anterior. Isso pode aumentar a latência, pois vários quadros podem ser decodificados antes que o quadro solicitado seja atingido. Para reduzir a latência, um aplicativo pode chamar esse método para localizar os dois quadros-chave mais próximos do tempo desejado e, em seguida, buscar um desses quadros-chave.

Requisitos

   
Cliente mínimo com suporte Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2012 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho mfidl.h

Confira também

IMFSeekInfo