Método CSourceSeeking.QueryPreferredFormat

[La característica asociada a esta página, DirectShow, es una característica heredada. Se ha reemplazado por MediaPlayer, IMFMediaEngine y Captura de audio/vídeo en Media Foundation. Esas características se han optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer, IMFMediaEngine y Audio/Video Capture en Media Foundation en lugar de DirectShow, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.

El QueryPreferredFormat método recupera el formato de hora preferido del objeto. Este método implementa el método IMediaSeeking::QueryPreferredFormat .

Sintaxis

HRESULT QueryPreferredFormat(
   GUID *pFormat
);

Parámetros

pFormat

Puntero a una variable que recibe un GUID de formato de hora. Consulte GUID de formato de hora.

Valor devuelto

Devuelve uno de los valores HRESULT enumerados en la tabla siguiente.

Código devuelto	Descripción
S_OK	Correcto
E_POINTER	Valor de puntero NULL

Observaciones

El único formato de hora admitido por la clase base es TIME_FORMAT_MEDIA_TIME (unidades de 100 nanosegundos).

Requisitos

Requisito	Value
Encabezado	Ctlutil.h (include Streams.h)
Biblioteca	Strmbase.lib (compilaciones comerciales); Strmbasd.lib (compilaciones de depuración)

Consulte también

CSourceSeeking (clase)