Partager via

IDiscMaster::SetActiveDiscMasterFormat, méthode (imapi.h)

  • Article

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.

Note Un appel à cette méthode peut modifier la liste des enregistreurs disponibles. Pour plus d’informations, consultez la section Notes de EnumDiscRecorders .
 

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

Voir aussi

IDiscMaster