Partager via


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