À propos de la gravure de CD

[La fonctionnalité associée à cette page, Lecteur multimédia Windows SDK, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer. MediaPlayer a été optimisé pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise MediaPlayer au lieu de Lecteur multimédia Windows SDK, 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.]

Le Kit de développement logiciel (SDK) Lecteur multimédia Windows 11 introduit de nouvelles fonctionnalités pour la création de CD. Ce processus est appelé burning.

Pour énumérer les lecteurs de CD sur l’ordinateur de l’utilisateur, utilisez l’interface IWMPCdromCollection . Vous récupérez un pointeur vers cette interface en appelant IWMPCore::get_cdromCollection. En utilisant les méthodes count et item , vous pouvez itérer la collection pour récupérer un pointeur d’interface IWMPCdrom pour chaque lecteur DE CD sur l’ordinateur de l’utilisateur. L’interface IWMPCdrom représente un lecteur DE CD individuel.

Avant de commencer à graver un CD, vous devez d’abord appeler QueryInterface via un pointeur IWMPCdrom pour récupérer un pointeur vers l’interface IWMPCdromBurn . À l’aide de la méthode isAvailable , vous pouvez déterminer si un lecteur de CD particulier peut graver des CD, s’il y a un CD dans le lecteur et comment le CD peut être utilisé.

Pour spécifier les éléments à graver sur CD, vous devez créer une playlist. Lecteur multimédia Windows représente les playlists à l’aide de l’interface IWMPPlaylist. Vous pouvez créer cette playlist comme vous le souhaitez. Par exemple, vous pouvez simplement récupérer une playlist à partir de la bibliothèque en appelant IWMPMediaCollection::getByAlbum. Après avoir créé la playlist que vous souhaitez graver sur CD, vous devez appeler la méthode IWMPCdromBurn::p ut_burnPlaylist et passer le pointeur de playlist comme argument. Cela définit votre playlist comme celle que Lecteur multimédia Windows copiera sur le CD.

Si vous récupérez une playlist à partir de la bibliothèque, toutes les modifications que vous apportez à la playlist seront reflétées dans la bibliothèque de l’utilisateur. Pour éviter cela, appelez IWMPPlaylist::setItemInfo, en passant le nom d’attribut « Temporary » et la valeur « true ». Cela convertit votre playlist instance en playlist temporaire, qui peut être modifiée sans modifier la playlist d’origine.

Chaque fois que vous définissez une nouvelle playlist pour la gravure ou apportez des modifications à une playlist de gravure existante, vous devez appeler IWMPCdromBurn::refreshStatus pour mettre à jour les informations status. Cela garantit que Lecteur multimédia Windows effectue le traitement nécessaire pour vous fournir des informations de status exactes pour l’opération de gravure de CD.

Pour spécifier le type de CD à graver, appelez IWMPCdromBurn::p ut_burnFormat. Lecteur multimédia Windows vous permet de graver deux types de CD : les CD audio et les CD de données. L’énumération WMPBurnFormat définit les types de CD.

Vous pouvez spécifier une étiquette de volume pour le CD en appelant IWMPCdromBurn::p ut_label.

Lorsque vous êtes prêt à commencer à graver le CD, appelez IWMPCdromBurn::startBurn. Vous pouvez surveiller la progression de l’opération de gravure en appelant régulièrement IWMPCdromBurn::get_burnProgress. Cette méthode récupère une valeur de progression pour l’ensemble de l’opération de gravure. La valeur récupérée est un nombre qui représente le pourcentage de gravure terminée. Vous pouvez surveiller l’état de l’opération de gravure en gérant l’événement IWMPEvents3::CdromBurnStateChange , qui utilise l’énumération WMPBurnState pour indiquer l’état actuel. Veillez à comparer le pointeur IWMPCdromBurn (fourni par l’événement) au pointeur qui représente votre opération de gravure pour vous assurer que l’événement a été déclenché par votre opération. Vous pouvez arrêter l’opération de combustion en appelant IWMPCdromBurn::stopBurn.

Vous pouvez gérer deux événements pour recevoir des notifications d’erreur concernant votre opération de gravure. L’événement IWMPEvents3::CdromBurnError est déclenché lorsqu’une erreur générique se produit. IWMPEvents3::CdromBurnMediaError est déclenché lorsqu’un élément multimédia particulier provoque une erreur lors de la gravure. Comme l’événement CdromBurnStateChange , chacun de ces événements fournit un pointeur IWMPCdromBurn qui représente l’opération de gravure qui a déclenché l’événement. L’événement CdromBurnMediaError fournit un pointeur IDispatch qui représente l’élément multimédia qui a déclenché l’événement. Vous pouvez appeler QueryInterface via ce pointeur pour récupérer un pointeur IWMPMedia .

Rubriques connexes

À propos du modèle objet player

IWMPCdrom Interface

IWMPCdromBurn, interface

IWMPCdromCollection Interface

IWMPEvents3 Interface

IWMPMedia Interface

IWMPPlaylist Interface

Attribut temporaire