Interface IDiscRecorder (imapi.h)
L’interface IDiscRecorder permet d’accéder à un seul appareil d’enregistrement de disque, étiqueté l’enregistreur de disque actif. Un objet IMAPI tel que MSDiscMasterObj gère un enregistreur de disque actif.
Un objet IDiscRecorder représente un seul appareil matériel, mais il peut y avoir plusieurs instances d’IDiscRecorder qui référencent toutes le même périphérique matériel. Dans ce cas, utilisez OpenExclusive pour accéder à cet appareil.
Héritage
L’interface IDiscRecorder hérite de l’interface IUnknown. IDiscRecorder comporte également les types de membres suivants :
Méthodes
L’interface IDiscRecorder possède ces méthodes.
| IDiscRecorder::Close Libère un accès exclusif à un enregistreur de disque. Cela restaure l’accès du système de fichiers au lecteur. |
| IDiscRecorder::Eject Déverrouille et éjecte le plateau de l’enregistreur de disque, si possible. |
| IDiscRecorder::Erase Tente d’effacer le média CD-RW s’il s’agit d’un enregistreur de disque CD-RW. Les effacements complets et rapides sont pris en charge. |
| IDiscRecorder::GetBasePnPID Récupère une chaîne PnP de base qui peut être utilisée pour identifier de manière cohérente une classe spécifique d’appareil par la fabrique et le modèle. La chaîne peut être utilisée par les applications pour personnaliser leur comportement en fonction du type d’enregistreur spécifique. |
| IDiscRecorder::GetDisplayNames Récupère un nom mis en forme pour l’enregistreur qui peut être affiché. Le nom se compose du fabricant et de l’identificateur de produit de l’appareil. |
| IDiscRecorder::GetPath Récupère un chemin d’accès à l’appareil dans le système d’exploitation. Ce chemin doit être utilisé conjointement avec le nom d’affichage pour identifier complètement un enregistreur de disque disponible. |
| IDiscRecorder::GetRecorderGUID Récupère le GUID de l’enregistreur de disque physique actuellement associé à l’objet enregistreur. |
| IDiscRecorder::GetRecorderProperties Récupère un pointeur vers une interface IPropertyStorage. |
| IDiscRecorder::GetRecorderState Récupère l’état de l’enregistreur de disque. |
| IDiscRecorder::GetRecorderType Détermine si l’enregistreur de disque est un appareil de type CD-R ou CD-RW. Cela n’indique pas le type de média actuellement inséré dans l’appareil. |
| IDiscRecorder::OpenExclusive Ouvre un enregistreur de disque pour un accès exclusif. |
| IDiscRecorder::QueryMediaInfo Récupère des informations sur le média actuellement monté, comme le nombre total de blocs utilisés sur le média. |
| IDiscRecorder::QueryMediaType Détecte le type de média actuellement inséré dans l’enregistreur, le cas échéant. |
| IDiscRecorder::SetRecorderProperties Accepte un pointeur IPropertyStorage pour un objet avec toutes les propriétés que l’application souhaite modifier. Les paramètres partiellement alloués sont pris en charge. |
Notes
Toutes les interfaces IDiscRecorder peuvent être utilisées sur un objet IDiscRecorder même si l’enregistreur de disque n’est pas l’enregistreur de disque actif. Le client IMAPI n’a pas besoin d’appeler IDiscMaster::SetActiveDiscRecorder en premier.
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 |