Méthode IDiscMaster ::RecordDisc (imapi.h)

Article
02/26/2024

Grave l’image mise en scène sur le média dans l’enregistreur de disque actif.

Syntaxe

HRESULT RecordDisc(
  [in] boolean bSimulate,
  [in] boolean bEjectAfterBurn
);

Paramètres

[in] bSimulate

Indique si le média est brûlé. Si ce paramètre a la valeur TRUE, le média de l’enregistreur de disque actif n’est pas réellement gravé. Au lieu de cela, une gravure simulée est effectuée. La simulation est un bon test d’un enregistreur de disque, car la plupart des opérations sont effectuées comme dans une gravure réelle. Si ce paramètre a la valeur FALSE, le média de l’enregistreur est en fait brûlé.

[in] bEjectAfterBurn

Indique s’il faut éjecter le média après la gravure. Si ce paramètre a la valeur TRUE, le média est éjecté. Si ce paramètre a la valeur FALSE, le média n’est pas éjecté.

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 :

Remarques

Cette méthode retourne une fois la gravure terminée, bien que des rappels de progression soient effectués s’ils sont inscrits auprès de la méthode ProgressAdvise . Toutes les erreurs entraînent le retour de cette méthode, avec peu ou pas d’action corrective de la part de cette méthode.

Les données d’image intermédiaires ne sont pas valides après un appel à RecordDisc. Cela permet à l’application d’effectuer une gravure simulée ou réelle du média. À des fins de sécurité, le contenu du fichier d’attente est effacé automatiquement une fois le premier appel réussi à cette méthode. Un disque doit être reposé pour le graver à nouveau.

La méthode RecordDisc s’attend à fonctionner avec un média vide pour l’audio. Sinon, il peut être nécessaire d’effacer le média (par exemple, le support CD-RW dans un lecteur DE CD-RW). Consultez IDiscRecorder ::Erase.

La méthode SetActiveDiscRecorder détermine s’il existe un disque multisession IMAPI dans le lecteur actif lors de la définition. Si c’est le cas, IMAPI passe automatiquement en mode multisession. Si en mode multisession et qu’un appel est effectué à RecordDisc, le même disque qui a établi le mode multisession doit se trouver dans l’enregistreur actif, sinon un code d’erreur de IMAPI_E_WRONGDISC est retourné.

Configuration requise

Condition requise	Valeur
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

Partager via