Partager via

Enregistrement du contenu

  • Article

[La fonctionnalité associée à cette page, le Kit de développement logiciel (SDK) Windows Media Format 11, est une fonctionnalité héritée. Il a été remplacé par lecteur source et enregistreur récepteur. Le lecteur source et l’enregistreur récepteur ont été optimisés pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise le lecteur source et l’enregistreur récepteur au lieu du Kit de développement logiciel (SDK) Windows Media Format 11, 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.]

À l’aide de ce kit sdk, une application peut enregistrer le contenu téléchargé ou diffusé en continu sur l’ordinateur local de l’utilisateur, en appelant la méthode IWMReaderAdvanced2::SaveFileAs sur l’objet lecteur. Pour le contenu diffusé en continu, le serveur doit utiliser la diffusion en cache rapide, qui est décrite dans la section Activation de la diffusion en cache rapide à partir du client. Pour le contenu diffusé en continu, la méthode SaveFileAs crée un fichier ASX qui pointe vers un fichier ASF contenant le contenu enregistré. Si l’objet lecteur diffuse en continu une playlist côté serveur, chaque entrée est enregistrée en tant que fichier ASF distinct, et le fichier ASX pointe vers chacun des fichiers ASF. Pour le contenu téléchargé, la méthode SaveFileAs crée simplement un fichier ASF.

Pour enregistrer du contenu dans un fichier local, procédez comme suit :

  1. Appelez IWMReader::Open avec l’URL. Open est un appel asynchrone et retourne immédiatement. Attendez la fin de l’opération, comme décrit dans Créer un lecteur et Ouvrir un fichier.
  2. Interrogez l’objet lecteur pour l’interface IWMReaderAdvanced4 .
  3. Vérifiez si le contenu peut être enregistré en appelant la méthode IWMReaderAdvanced4::CanSaveFileAs . Si la méthode retourne False, le contenu ne peut pas être enregistré localement. Sinon, passez à l’étape 4.
  4. Appelez la méthode IWMReaderAdvanced4::IsUsingFastCache pour déterminer si le serveur utilise le streaming Fast Cache.
  5. Appelez IWMReaderAdvanced2::SaveFileAs avec un nom de fichier pour le fichier local. Si la méthode IsUsingFastCache a retourné True, attribuez au nom de fichier une extension .asx. Sinon, donnez au nom de fichier une extension .asf, .wma ou .wmv.

L’application peut annuler l’opération d’enregistrement pendant qu’elle est en cours, en appelant la méthode IWMReaderAdvanced4::CancelSaveFileAs .

Le contenu enregistré peut être protégé par DRM, de sorte qu’il n’est peut-être pas possible de lire le fichier sur un autre ordinateur. Pour plus d’informations sur la protection du contenu, consultez Fonctionnalités de gestion des droits numériques.

IWMReader Interface

IWMReaderAdvanced2, interface