Método IMFSourceReader::SetCurrentPosition (mfreadwrite.h)

Busca una nueva posición en el origen multimedia.

Sintaxis

HRESULT SetCurrentPosition(
  [in] REFGUID        guidTimeFormat,
  [in] REFPROPVARIANT varPosition
);

Parámetros

[in] guidTimeFormat

GUID que especifica el formato de hora. El formato de hora define las unidades para el parámetro varPosition . El siguiente valor se define para todos los orígenes multimedia:

Valor	Significado
GUID_NULL	Unidades de 100 nanosegundos.

 

Algunos orígenes multimedia pueden admitir valores adicionales.

[in] varPosition

Posición desde la que se iniciará la reproducción. Las unidades se especifican mediante el parámetro guidTimeFormat . Si el parámetro guidTimeFormat está GUID_NULL, establezca el tipo de variante en VT_I8.

Valor devuelto

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Código devuelto	Descripción
S_OK	El método se ha llevado a cabo de forma correcta.
MF_E_INVALIDREQUEST	Una o varias solicitudes de ejemplo siguen pendientes.

Comentarios

El método SetCurrentPosition no garantiza la búsqueda exacta. La precisión de la búsqueda depende del contenido multimedia. Si el contenido multimedia contiene una secuencia de vídeo, el método SetCurrentPosition normalmente busca el fotograma clave más cercano antes de la posición deseada. La distancia entre fotogramas clave depende de varios factores, incluida la implementación del codificador, el contenido de vídeo y la configuración de codificación determinada que se usa para codificar el contenido. La distancia entre fotograma clave puede variar dentro de un único archivo de vídeo (por ejemplo, dependiendo de la complejidad de la escena).

Después de buscar, la aplicación debe llamar a IMFSourceReader::ReadSample y avanzar a la posición deseada.

Esta interfaz está disponible en Windows Vista si está instalado El complemento de actualización de la plataforma para Windows Vista.

Requisitos

Requisito	Value
Cliente mínimo compatible	Complemento de actualización de Windows 7, Windows Vista y plataforma para Windows Vista [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2008 R2 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	mfreadwrite.h

Consulte también

IMFSourceReader

Lector de origen