IDiscMaster::EnumDiscRecorders, méthode (imapi.h)
Récupère un énumérateur pour tous les enregistreurs de disques pris en charge par le format de master disque actif.
Syntaxe
HRESULT EnumDiscRecorders(
[out] IEnumDiscRecorders **ppEnum
);
Paramètres
[out] ppEnum
Adresse d’un pointeur vers l’énumérateur IEnumDiscRecorders .
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
IEnumDiscRecorders est un énumérateur COM standard, comme documenté dans IEnumXXXX. Chaque appel à Suivant retourne un tableau de pointeurs vers IDiscRecorder. Chaque interface d’enregistreur représente un seul enregistreur disponible déjà associé à un enregistreur de disque physique sous-jacent.
La liste des enregistreurs disponibles peut changer en raison d’arrivées ou de départs plug-and-play, ou d’un appel à SetActiveDiscMasterFormat. Une application est informée de ces modifications lorsqu’elle reçoit un appel à IDiscMasterProgressEvents::NotifyPnPActivity. Lorsqu’une modification se produit, l’application doit appeler à nouveau cette méthode pour récupérer un nouvel énumérateur, car chaque énumérateur contient un instantané des appareils pris en charge au moment de l’énumération.
Lorsqu’un appareil est supprimé, son pointeur et son interface IDiscRecorder doivent rester valides même si l’appareil physique sous-jacent est manquant. Dans ce cas, les opérations sur un IDiscRecorder ou une demande d’enregistrement d’un disque peuvent retourner IMAPI_E_DEVICE_NOTPRESENT.
La propriété MaxWriteSpeed est mise à jour lorsque cette méthode est appelée. Le paramètre par défaut est la vitesse d’écriture disponible la plus élevée.
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 |