Interface IWriteEngine2 (imapi2.h)
Utilisez cette interface pour écrire un flux de données sur un appareil.
Cette interface doit être utilisée par ceux qui développent la prise en charge de nouveaux types ou formats de médias. L’écriture dans un média comprend généralement les étapes suivantes :
- Préparation du matériel en définissant des pages de mode pour le média.
- Interrogation du matériel pour vérifier que le média est suffisamment grand.
- Initialisation de l’écriture, par exemple, en mettant en forme le média ou en définissant OPC.
- Exécution des commandes WRITE réelles.
- Terminer l’écriture en arrêtant la mise en forme ou en fermant la session ou le suivi.
La plupart des applications clientes doivent utiliser l’interface IDiscFormat2Data pour écrire des images sur un appareil.
Pour créer un instance de cette interface, appelez la fonction CoCreateInstance. Use__uuidof(MsftWriteEngine2) pour l’identificateur de classe et __uuidof(IWriteEngine2) pour l’identificateur d’interface.
Héritage
L’interface IWriteEngine2 hérite de l’interface IDispatch. IWriteEngine2 a également les types de membres suivants :
Méthodes
L’interface IWriteEngine2 a ces méthodes.
| IWriteEngine2 ::CancelWrite Annule une opération d’écriture en cours. |
| IWriteEngine2 ::get_BytesPerSector Récupère le nombre d’octets à utiliser pour chaque secteur lors de l’écriture. La valeur retournée indique la valeur précédemment définie avec IWriteEngine2 ::p ut_BytesPerSector, et ne retourne pas de valeur actuelle d’octets par secteur pour le média. |
| IWriteEngine2 ::get_EndingSectorsPerSecond Récupère le nombre estimé de secteurs par seconde que le périphérique d’enregistrement peut écrire sur le support à la fin du processus d’écriture. |
| IWriteEngine2 ::get_Recorder Récupère le périphérique d’enregistrement à utiliser dans l’opération d’écriture. |
| IWriteEngine2 ::get_StartingSectorsPerSecond Récupère le nombre estimé de secteurs par seconde que le périphérique d’enregistrement peut écrire sur le média au début du processus d’écriture. |
| IWriteEngine2 ::get_UseStreamingWrite12 Récupère une valeur qui indique si les opérations d’écriture utilisent la commande WRITE12 ou WRITE10. |
| IWriteEngine2 ::get_WriteInProgress Récupère une valeur qui indique si l’enregistreur écrit actuellement des données sur le disque. |
| IWriteEngine2 ::p ut_BytesPerSector Définit le nombre d’octets à utiliser pour chaque secteur lors de l’écriture. |
| IWriteEngine2 ::p ut_EndingSectorsPerSecond Définit le nombre estimé de secteurs par seconde que le périphérique d’enregistrement peut écrire sur le média à la fin du processus d’écriture. |
| IWriteEngine2 ::p ut_Recorder Définit un périphérique d’enregistrement pour l’opération d’écriture. |
| IWriteEngine2 ::p ut_StartingSectorsPerSecond Définit le nombre estimé de secteurs par seconde que le périphérique d’enregistrement peut écrire sur le média au début du processus d’écriture. |
| IWriteEngine2 ::p ut_UseStreamingWrite12 Définit une valeur qui indique si les opérations d’écriture utilisent la commande WRITE12 ou WRITE10. |
| IWriteEngine2 ::WriteSection Écrit un flux de données dans l’enregistreur actuel. |
Remarques
Pour créer l’objet MsftWriteEngine2 dans un script, utilisez IMAPI2. MsftWriteEngine2 comme identificateur de programme lors de l’appel de CreateObject.
Il est possible qu’une transition de l’état d’alimentation se produise pendant une opération de brûlure (c’est-à-dire la déconnexion de l’utilisateur ou la suspension du système), ce qui entraîne l’interruption du processus de brûlure et une perte de données possible. Pour plus d’informations sur la programmation, consultez Prévention de la déconnexion ou de la suspension pendant une gravure.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista, Windows XP avec SP2 [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2003 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | imapi2.h |