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 |