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

  • Artículo

Para una posición de búsqueda determinada, obtiene los dos fotogramas clave más cercanos.

Sintaxis

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

Parámetros

[in] pguidTimeFormat

Puntero a un GUID que especifica el formato de hora. El formato de hora define las unidades para los demás parámetros de este método. Si el valor es GUID_NULL, el formato de hora es de 100 unidades nanosegundas. Algunos orígenes multimedia pueden admitir GUID de formato de tiempo adicionales.

[in] pvarStartPosition

Posición de búsqueda. Las unidades de este parámetro se especifican mediante pguidTimeFormat.

[out] pvarPreviousKeyFrame

Recibe la posición del fotograma clave más cercano que aparece antes de pvarStartPosition. Las unidades de este parámetro se especifican mediante pguidTimeFormat.

[out] pvarNextKeyFrame

Recibe la posición del fotograma clave más cercano que aparece más adelante que pvarStartPosition. Las unidades de este parámetro se especifican mediante pguidTimeFormat.

Valor devuelto

Este método puede devolver uno de estos valores.

Código devuelto Descripción
S_OK
 El método se ha llevado a cabo de forma correcta.
MF_E_UNSUPPORTED_TIME_FORMAT
 No se admite el formato de hora especificado en pguidTimeFormat .

Comentarios

Si una aplicación busca un fotograma no clave, el descodificador debe iniciar la descodificación del fotograma clave anterior. Esto puede aumentar la latencia, ya que es posible que varios fotogramas se descodifiquen antes de que se alcance el marco solicitado. Para reducir la latencia, una aplicación puede llamar a este método para buscar los dos fotogramas clave más cercanos al tiempo deseado y, a continuación, buscar uno de esos fotogramas clave.

Requisitos

   
Cliente mínimo compatible Windows 8 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2012 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado mfidl.h

Consulte también

IMFSeekInfo