Partager via

Méthode CSourceSeeking.QueryPreferredFormat

  • Article

[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer, IMFMediaEngine et Audio/Video Capture in Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise MediaPlayer, IMFMediaEngine et Audio/Video Capture dans Media Foundation au lieu de DirectShow, si possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]

La QueryPreferredFormat méthode récupère le format d’heure préféré de l’objet. Cette méthode implémente la méthode IMediaSeeking::QueryPreferredFormat .

Syntaxe

HRESULT QueryPreferredFormat(
   GUID *pFormat
);

Paramètres

pFormat

Pointeur vers une variable qui reçoit un GUID de format d’heure. Consultez GUID de format d’heure.

Valeur renvoyée

Retourne l’une des valeurs HRESULT répertoriées dans le tableau suivant.

Code de retour Description
S_OK
 Succès
E_POINTER
 Valeur du pointeur NULL

Notes

Le seul format d’heure pris en charge par la classe de base est TIME_FORMAT_MEDIA_TIME (unités de 100 nanosecondes).

Configuration requise

Condition requise Valeur
En-tête
Ctlutil.h (include Streams.h)
Bibliothèque
Strmbase.lib (builds de vente au détail) ;
Strmbasd.lib (builds de débogage)

Voir aussi

CSourceSeeking, classe