IWriteEngine2-Schnittstelle (imapi2.h)
Verwenden Sie diese Schnittstelle, um einen Datenstrom auf ein Gerät zu schreiben.
Diese Schnittstelle sollte von Personen verwendet werden, die Unterstützung für neue Medientypen oder Formate entwickeln. Das Schreiben auf Medien umfasst in der Regel die folgenden Schritte:
- Vorbereiten der Hardware durch Festlegen von Modusseiten für die Medien.
- Abfragen der Hardware, um zu überprüfen, ob die Medien groß genug sind.
- Initialisieren des Schreibvorgangs, z. B. durch Formatieren des Mediums oder Festlegen von OPC.
- Ausführen der tatsächlichen WRITE-Befehle.
- Beenden sie den Schreibvorgang, indem Sie die Formatierung beenden oder die Sitzung oder den Track schließen.
Die meisten Clientanwendungen sollten die IDiscFormat2Data-Schnittstelle verwenden, um Bilder auf ein Gerät zu schreiben.
Rufen Sie die Funktion CoCreateInstance auf, um eine instance dieser Schnittstelle zu erstellen. Use__uuidof(MsftWriteEngine2) für den Klassenbezeichner und __uuidof(IWriteEngine2) für den Schnittstellenbezeichner.
Vererbung
Die IWriteEngine2-Schnittstelle erbt von der IDispatch-Schnittstelle . IWriteEngine2 verfügt auch über folgende Membertypen:
Methoden
Die IWriteEngine2-Schnittstelle verfügt über diese Methoden.
| IWriteEngine2::CancelWrite Bricht einen Schreibvorgang ab, der gerade ausgeführt wird. |
| IWriteEngine2::get_BytesPerSector Ruft die Anzahl der Bytes ab, die während des Schreibens für jeden Sektor verwendet werden sollen. Der zurückgegebene Wert gibt an, was der Wert zuvor mit IWriteEngine2::p ut_BytesPerSector festgelegt hat, und gibt keinen aktuellen Bytewert pro Sektor für Medien zurück. |
| IWriteEngine2::get_EndingSectorsPerSecond Ruft die geschätzte Anzahl von Sektoren pro Sekunde ab, die das Aufzeichnungsgerät am Ende des Schreibprozesses auf die Medien schreiben kann. |
| IWriteEngine2::get_Recorder Ruft das Aufzeichnungsgerät ab, das beim Schreibvorgang verwendet werden soll. |
| IWriteEngine2::get_StartingSectorsPerSecond Ruft die geschätzte Anzahl von Sektoren pro Sekunde ab, die das Aufzeichnungsgerät zu Beginn des Schreibprozesses auf die Medien schreiben kann. |
| IWriteEngine2::get_UseStreamingWrite12 Ruft einen Wert ab, der angibt, ob die Schreibvorgänge den Befehl WRITE12 oder WRITE10 verwenden. |
| IWriteEngine2::get_WriteInProgress Ruft einen Wert ab, der angibt, ob der Rekorder derzeit Daten auf den Datenträger schreibt. |
| IWriteEngine2::p ut_BytesPerSector Legt die Anzahl der Bytes fest, die während des Schreibens für jeden Sektor verwendet werden sollen. |
| IWriteEngine2::p ut_EndingSectorsPerSecond Legt die geschätzte Anzahl von Sektoren pro Sekunde fest, die das Aufzeichnungsgerät am Ende des Schreibprozesses auf die Medien schreiben kann. |
| IWriteEngine2::p ut_Recorder Legt ein Aufzeichnungsgerät für den Schreibvorgang fest. |
| IWriteEngine2::p ut_StartingSectorsPerSecond Legt die geschätzte Anzahl von Sektoren pro Sekunde fest, die das Aufzeichnungsgerät zu Beginn des Schreibprozesses auf die Medien schreiben kann. |
| IWriteEngine2::p ut_UseStreamingWrite12 Legt einen Wert fest, der angibt, ob die Schreibvorgänge den Befehl WRITE12 oder WRITE10 verwenden. |
| IWriteEngine2::WriteSection Schreibt einen Datenstrom in den aktuellen Recorder. |
Hinweise
Verwenden Sie IMAPI2, um das MsftWriteEngine2-Objekt in einem Skript zu erstellen. MsftWriteEngine2 als Programmbezeichner beim Aufrufen von CreateObject.
Es ist möglich, dass während eines Brennvorgangs (z. B. Benutzerabmeldung oder Systemunterbrechung) ein Energiezustandsübergang stattfindet, der zu einer Unterbrechung des Brennprozesses und einem möglichen Datenverlust führt. Überlegungen zur Programmierung finden Sie unter Verhindern von Abmeldung oder Anhalten während eines Brennvorgangs.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista, Windows XP mit SP2 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | imapi2.h |