ImfMediaSession ::Start, méthode (mfidl.h)

  • Article

Démarre la session multimédia.

Syntaxe

HRESULT Start(
  [in] const GUID        *pguidTimeFormat,
  [in] const PROPVARIANT *pvarStartPosition
);

Paramètres

[in] pguidTimeFormat

Pointeur vers un GUID qui spécifie le format d’heure du paramètre pvarStartPosition . Ce paramètre peut être NULL. La valeur NULL équivaut à passer GUID_NULL.

Les GUID de format d’heure suivants sont définis :

Valeur Signification
GUID_NULL
 Heure de présentation. Le paramètre pvarStartPosition doit avoir l’un des types PROPVARIANT suivants.
  • VT_I8 : le paramètre pvarStartPosition contient la position de départ en unités de 100 nanosecondes, par rapport au début de la présentation.
  • VT_EMPTY : la lecture démarre à partir de la position actuelle.
Toutes les sources multimédias prennent en charge ce format d’heure.
MF_TIME_FORMAT_SEGMENT_OFFSET
 Décalage de segment. Ce format d’heure est pris en charge par la source sequencer. L’heure de début est un décalage dans un segment.

Appelez la fonction MFCreateSequencerSegmentOffset pour créer la valeur PROPVARIANT pour le paramètre pvarStartPosition .
MF_TIME_FORMAT_ENTRY_RELATIVE
Note Nécessite Windows 7 ou version ultérieure.
 
Passez à une entrée de playlist. Le paramètre pvarStartPosition spécifie l’index de l’entrée de playlist, par rapport à l’entrée actuelle. Par exemple, la valeur 2 ignore deux entrées. Pour passer en arrière, transmettez une valeur négative. Le type PROPVARIANT est VT_I4.

Si une source multimédia prend en charge ce format d’heure, la méthode IMFMediaSource ::GetCharacteristics retourne un ou les deux indicateurs suivants :

  • MFMEDIASOURCE_CAN_SKIPFORWARD
  • MFMEDIASOURCE_CAN_SKIPBACKWARD

[in] pvarStartPosition

Pointeur vers un PROPVARIANT qui spécifie la position de départ pour la lecture. La signification et le type de données de ce paramètre sont indiqués par le paramètre pguidTimeFormat .

Valeur retournée

Cette méthode retourne un code HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

Code de retour Description
S_OK
 S_OK
MF_E_INVALIDREQUEST
 L’opération ne peut pas être effectuée dans l’état actuel de la session multimédia.
MF_E_SHUTDOWN
 La session multimédia a été arrêtée.

Remarques

Lorsque cette méthode est appelée, la session multimédia démarre l’horloge de présentation et commence à traiter des exemples multimédias.

Cette méthode est asynchrone. Une fois la méthode terminée, la session multimédia envoie un événement MESessionStarted .

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
Plateforme cible Windows
En-tête mfidl.h
Bibliothèque Mfuuid.lib

Voir aussi

IMFMediaSession