IDiscMaster::SetActiveDiscMasterFormat, méthode (imapi.h)
Définit le format de l’enregistreur de disques actif. Le format actif spécifie à la fois la structure du contenu du fichier image intermédiaire (audio/données) et l’interface COM qui doit être utilisée pour manipuler cette image intermédiaire.
Syntaxe
HRESULT SetActiveDiscMasterFormat(
[in] REFIID riid,
[out] void **ppUnk
);
Paramètres
[in] riid
IID du format actif.
[out] ppUnk
Pointeur vers l’interface COM pour le nouveau format de disque.
Valeur retournée
S_OK est retourné en cas de réussite, mais d’autres codes de réussite peuvent être retournés à la suite de l’implémentation. Les codes d’erreur suivants sont généralement retournés en cas d’échec de l’opération, mais ne représentent pas les seules valeurs d’erreur possibles :
Notes
Un appel réussi à cette méthode efface le contenu de l’image actuellement intermédiaire. En outre, il peut modifier la liste des enregistreurs de disques pris en charge. En effet, tous les enregistreurs ne prennent pas en charge tous les formats. Les modifications apportées à la liste des enregistreurs sont annoncées avec IDiscMasterProgressEvents::NotifyPnPActivity. Si l’enregistreur sélectionné n’est pas membre du nouvel ensemble d’appareils pris en charge, il n’y aura plus d’enregistreur actif (semblable à l’état après le premier appel à Ouvrir). Dans ce cas, l’application doit sélectionner un nouvel enregistreur actif avant de lancer une gravure.
MSDiscMasterObj prend uniquement en charge les ID suivants : IID_IRedbookDiscMaster (IRedbookDiscMaster) et IID_IJolietDiscMaster (IJolietDiscMaster). S’il n’y a pas de format défini, la valeur par défaut est le format Joliet. Il incombe à chaque application de sélectionner un format master à l’aide d’EnumDiscMasterFormats et de cette méthode.
Configuration requise
| Client minimal pris en charge | Windows XP [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2003 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | imapi.h |
| Bibliothèque | Uuid.lib |
| DLL | Actxprxy.dll |