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

Article
03/01/2024

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

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

Partager via