IAMTimecodeReader ::GetTimecode, méthode (strmif.h)

[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer, IMFMediaEngine et Audio/Video Capture dans Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement au nouveau code d’utiliser MediaPlayer, IMFMediaEngine et La capture audio/vidéo dans Media Foundation au lieu de DirectShow, lorsque cela est 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 GetTimecode méthode récupère les valeurs de timecode, de userbit et d’indicateur les plus récentes disponibles dans le flux.

Syntaxe

HRESULT GetTimecode(
  [out] PTIMECODE_SAMPLE pTimecodeSample
);

Paramètres

[out] pTimecodeSample

Pointeur vers une structure TIMECODE_SAMPLE .

Valeur retournée

Retourne une valeur HRESULT qui dépend de l’implémentation de l’interface.

Remarques

Utilisez cette méthode pour surveiller le timecode et analyser les doublons et les discontinuités.

Le timecode contient des bits non définis, appelés userbits. Les applications peuvent utiliser ces bits pour stocker des informations de synchronisation ou d’autres informations personnalisées.

Implémentation du caméscope DV et MPEG

Le pilote MSDV prend en charge la lecture du timecode SMPTE ou des numéros de piste absolus (ATN). Le pilote MSTape prend en charge la lecture du compteur de temps relatif (RTC). Pour lire les informations de temps sur ces appareils, procédez comme suit :

Définissez le membre dwFlags de la structure TIMECODE_SAMPLE sur l’une des valeurs suivantes.

Constant	Description
ED_DEVCAP_TIMECODE_READ	Timecode (DV)
ED_DEVCAP_ATN_READ	Numéro de piste absolu (DV)
ED_DEVCAP_RTC_READ	Compteur de temps relatif (bande MPEG)

 

Le membre timecode de la structure TIMECODE_SAMPLE est une structure TIMECODE . Initialisez le membre dwFrames de cette structure à zéro.

Tous les autres membres de la structure sont ignorés.

Lorsque la méthode retourne, le membre dwFrames contient les informations d’heure, au format suivant.

Informations sur l’heure	Format
Timecode	Heures, minutes, secondes et images, sous forme de valeur décimale codée binaire (BCD) : 0xhhmmssff.
ATN	Numéro de suivi.
RTC	Heures, minutes, secondes et images, sous forme de valeur BCD : 0xhhmmssff. Le bit le plus significatif de l’octet frames est un bit de signe. Si le nombre d’images n’est pas disponible, les bits d’image restants sont définis sur 0x7F.

 

En outre, le membre dwUser reçoit le bit d’indicateur vide de l’appareil, qui a l’une des valeurs suivantes.

Valeur	Description
0x00	Pas une discontinuité.
0x01	Discontinuité.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	strmif.h (include Dshow.h)
Bibliothèque	Strmiids.lib

Voir aussi

Codes d’erreur et de réussite

Obtention du timecode à partir de l’appareil

IAMTimecodeReader, interface