IAMExtTransport ::SetTransportBasicParameters, 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 SetTransportBasicParameters méthode définit les propriétés générales du transport.

Syntaxe

HRESULT SetTransportBasicParameters(
  [in] long      Param,
  [in] long      Value,
  [in] LPCOLESTR pszData
);

Paramètres

[in] Param

Spécifie la propriété à définir. Pour plus d'informations, consultez la section Notes.

[in] Value

Spécifie la valeur de la propriété sous forme d’entier long . Pour plus d'informations, consultez la section Notes.

[in] pszData

Spécifie la valeur de la propriété en tant que LPOLESTR. Pour plus d'informations, consultez la section Notes.

Valeur retournée

Lorsque cette méthode réussit, elle retourne S_OK. Sinon, il retourne un code d’erreur HRESULT . Les codes d’erreur possibles sont les suivants.

Remarques

Le paramètre Param est un indicateur qui spécifie la propriété à définir. Pour certains indicateurs, la propriété est numérique ; utilisez le paramètre Value pour spécifier la valeur. Pour les autres indicateurs, la propriété est une chaîne ; utilisez le paramètre pszData pour spécifier la valeur. Dans les deux cas, la méthode ignore l’autre paramètre.

Pour les indicateurs suivants, le paramètre Value prend une constante définie.

• ED_TRANSBASIC_TIME_FORMAT : spécifie le format d’heure.

  Constant	Description
  ED_FORMAT_MILLISECONDS	Millisecondes.
  ED_FORMAT_FRAMES	Cadres.
  ED_FORMAT_REFERENCE_TIME	Heure de référence.
  ED_FORMAT_HMSF	Décimale codée binaire, représentant des heures, des minutes, des secondes et des images.
  ED_FORMAT_TMSF	Décimale codée binaire, représentant les pistes, les minutes, les secondes et les images.

   
• ED_TRANSBASIC_TIME_REFERENCE : spécifie l’heure d’utilisation de référence par l’appareil.

  Constant	Description
  ED_TIMEREF_TIMECODE	Code d’heure.
  ED_TIMEREF_CONTROL_TRACK	Piste de contrôle.
  ED_TIMEREF_INDEX	Index.
  ED_TIMEREF_ATN	Numéro de piste absolu. Cette constante est définie dans le fichier d’en-tête Xprtdefs.h.

   
• ED_TRANSBASIC_END_STOP_ACTION : spécifie l’action de l’appareil lorsqu’il atteint la fin du support de transport.

  Constant	Description
  ED_MODE_STOP	Arrêter.
  ED_MODE_REWIND	Rembobiner.
  ED_MODE_FREEZE	Figer/suspendre.

   
• ED_TRANSBASIC_RECORD_FORMAT : spécifie la vitesse d’enregistrement.

  Constant	Description
  ED_RECORD_FORMAT_SP	Jeu standard.
  ED_RECORD_FORMAT_LP	Jeu long.
  ED_RECORD_FORMAT_EP	Jeu étendu.

   
• ED_TRANSBASIC_SUPERIMPOSE : spécifie si l’affichage à l’écran est activé ou désactivé.

  Constant	Description
  OATRUE	L’affichage à l’écran est activé.
  OAFALSE	L’affichage à l’écran est désactivé.

   
• ED_TRANSBASIC_STEP_UNIT : spécifie l’unité d’étape.

  Constant	Description
  ED_STEP_FIELD	Champs.
  ED_STEP_FRAME	Cadres.
  ED_STEP_3_2	3/2 Pulldown.

   
• ED_TRANSBASIC_SET_COUNTER_FORMAT : définit le format d’heure du compteur. Consultez l’indicateur ED_TRANSBASIC_TIME_FORMAT pour connaître les valeurs possibles.

Pour les indicateurs suivants, utilisez une chaîne dans le paramètre pszData .

Implémentation de DV

MSDV ne prend pas en charge cette méthode. Il retourne E_NOTIMPL.

Configuration requise

Voir aussi

Codes d’erreur et de réussite

IAMExtTransport, interface

IAMExtTransport ::GetTransportBasicParameters