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.

Code de retour Description
E_NOTIMPL
L’appareil ne prend pas en charge la définition de cette propriété.
ERROR_DEVICE_REMOVED
L’appareil a été supprimé.

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 valeur numérique dans le paramètre Value .
Indicateur Description
ED_TRANSBASIC_STEP_COUNT Spécifie le nombre d’étapes, en unités définies par l’indicateur ED_TRANSBASIC_STEP_UNIT.
ED_TRANSBASIC_SET_FREEZE_TIMEOUT Spécifie le délai d’attente pour le mode de gel, en unités du format d’heure actuel.
ED_TRANSBASIC_SETCLOCK Définit l’heure d’horloge.
ED_TRANSBASIC_SET_COUNTER_VALUE Définit la valeur du compteur.
 

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

Indicateur Description
ED_TRANSBASIC_VOLUME_NAME Spécifie le nom du volume.
 

Implémentation de DV

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

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

IAMExtTransport, interface

IAMExtTransport ::GetTransportBasicParameters