MÉTHODE IMFMediaSource::P ause (mfidl.h)
Interrompt tous les flux actifs dans la source multimédia.
Syntaxe
HRESULT Pause();
Valeur de retour
Cette méthode retourne un code HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.
| Code de retour | Description |
|---|---|
|
S_OK |
|
Transition d’état non valide. La source multimédia doit être à l’état démarré. |
|
La méthode Shutdown de la source multimédia a été appelée. |
Notes
Cette méthode est asynchrone. Une fois l’opération terminée, la source multimédia envoie et l’événement MESourcePaused , et chaque flux actif envoie un événement MEStreamPaused . Si la méthode retourne un code d’échec, aucun événement n’est déclenché.
La source multimédia doit être à l’état démarré. La méthode échoue si la source multimédia est suspendue ou arrêtée.
Lorsque la source est suspendue, les appels à IMFMediaStream::RequestSample réussissent, mais les flux ne livrent aucun échantillon tant qu’une fois la source redémarré. Notez que la file d’attente d’événements de la source n’est pas sérialisée avec les files d’attente d’événements de flux, de sorte que le client peut recevoir des exemples après l’événement MESourcePaused , en raison de problèmes de multithreading. Toutefois, le client ne recevra aucun exemple d’un flux après l’événement MEStreamPaused .
Toutes les sources multimédias ne peuvent pas être suspendues. Si une source multimédia peut s’interrompre, la méthode IMFMediaSource::GetCharacteristics retourne l’indicateur MFMEDIASOURCE_CAN_PAUSE.
Configuration requise
| Client minimal pris en charge | Windows Vista [applications de bureau | applications UWP] |
| Serveur minimal pris en charge | Windows Server 2008 [applications de bureau | applications UWP] |
| Plateforme cible | Windows |
| En-tête | mfidl.h |
| Bibliothèque | Mfuuid.lib |