IDiscFormat2Erase::EraseMedia-Methode (imapi2.h)
Löscht die Medien im aktiven Datenträgerrecorder.
Syntax
HRESULT EraseMedia();
Rückgabewert
S_OK wird bei Erfolg zurückgegeben, aber andere Erfolgscodes können als Ergebnis der Implementierung zurückgegeben werden. Die folgenden Fehlercodes werden häufig bei Vorgangsfehlern zurückgegeben, stellen aber nicht die einzigen möglichen Fehlerwerte dar:
| Rückgabecode | Beschreibung |
|---|---|
|
Der Zeiger ist ungültig.
Wert: 0x80004003 |
|
Unspezifizierter Fehler.
Wert: 0x80004005 |
|
Fehler beim Zuweisen des erforderlichen Arbeitsspeichers.
Wert: 0x8007000E |
|
Das Gerät konnte den Befehl innerhalb des Timeoutzeitraums nicht annehmen. Dies kann dadurch verursacht werden, dass das Gerät einen inkonsistenten Zustand eingegeben hat, oder der Timeoutwert für den Befehl muss möglicherweise erhöht werden.
Wert: 0xC0AA020D |
|
Das Gerät hat unerwartete oder ungültige Daten für einen Befehl gemeldet.
Wert: 0xC0AA02FF |
|
Die Medien werden kopfüber eingefügt.
Wert: 0xC0AA0204 |
|
Das Laufwerk hat gemeldet, dass es gerade bereit ist. Versuchen Sie die Anforderung später erneut.
Wert: 0xC0AA0205 |
|
Das Gerät enthält keine Medien.
Wert: 0xC0AA0202 |
|
Die Medien werden derzeit formatiert. Warten Sie, bis das Format abgeschlossen ist, bevor Sie versuchen, die Medien zu verwenden.
Wert: 0xC0AA0206 |
|
Das Laufwerk hat gemeldet, dass es einen Vorgang mit langer Ausführung ausführt, z. B. das Beenden eines Schreibvorgangs. Das Laufwerk kann für einen längeren Zeitraum unbrauchbar sein.
Wert: 0xC0AA0207 |
|
Fehler beim Schreiben, da das Laufwerk daten nicht schnell genug empfangen hat, um mit dem Schreiben fortzufahren. Wenn Sie die Quelldaten auf den lokalen Computer verschieben, die Schreibgeschwindigkeit verringern oder die Einstellung "Pufferunterlauf frei" aktivieren, kann dieses Problem behoben werden.
Wert: 0xC0AA0300 |
|
Die Medien sind nicht kompatibel oder haben kein unbekanntes physisches Format.
Wert: 0xC0AA0203 |
|
Die DVD-Struktur ist nicht vorhanden. Dies kann durch inkompatibles Laufwerk/Medium verursacht werden.
Wert: 0xC0AA020E |
|
Das Gerät hat gemeldet, dass die angeforderte Modusseite (und der Typ) nicht vorhanden sind.
Wert: 0xC0AA0201 |
|
Das Laufwerk meldete, dass die Kombination von Parametern, die auf der Modusseite für einen MODUS SELECT-Befehl bereitgestellt wurden, nicht unterstützt wurde.
Wert: 0xC0AA0208 |
|
Das Laufwerk meldete, dass das Medium schreibgeschützt ist.
Wert: 0xC0AA0209 |
|
Die Geschwindigkeit des Mediums ist mit dem Gerät nicht kompatibel. Dies kann durch die Verwendung von Medien mit höherer oder niedrigerer Geschwindigkeit als der vom Gerät unterstützte Geschwindigkeitsbereich verursacht werden.
Wert: 0xC0AA020F |
|
Das angegebene Handle ist ungültig.
Wert: 6 |
|
Die angegebene Netzwerkressource oder das angegebene Gerät ist nicht mehr verfügbar.
Wert: 55 |
|
Das diesem Rekorder während des letzten Vorgangs zugeordnete Gerät wurde ausschließlich gesperrt, sodass dieser Vorgang nicht erfolgreich war.
Wert: 0xC0AA0210 |
|
Der aktuelle Medientyp wird nicht unterstützt.
Wert: 0xC0AA0909 |
|
Das Laufwerk hat einen Fehler für einen START UNIT-Befehl (Spinup) zurückgegeben. Möglicherweise ist ein manueller Eingriff erforderlich.
Wert: 0x80AA0908 |
|
Das Laufwerk hat die Löschung nicht in einer Stunde abgeschlossen. Das Laufwerk erfordert möglicherweise einen Netzzyklus, das Entfernen von Medien oder einen anderen manuellen Eingriff, um den ordnungsgemäßen Betrieb fortzusetzen.
Hinweis Derzeit wird dieser Wert auch zurückgegeben, wenn ein Versuch, eine Löschung auf CD-RW- oder DVD-RW-Medien über die IDiscFormat2Erase-Schnittstelle durchzuführen, aufgrund eines fehlerhaften Mediums fehlschlägt.
|
Hinweise
Löscht die Medien synchron. Der Fortschritt kann durch Aufrufen von registrierten Ereignissen des Typs DDiscFormat2EraseEvents gemeldet werden.
Bevor Sie diese Methode aufrufen, müssen Sie die folgenden Methoden aufrufen:
Sie sollten auch erwägen, die IDiscFormat2Erase::p ut_FullErase-Methode aufzurufen, wenn ihr Standardwert nicht für Ihre Anwendung geeignet ist.Diese Methode ist synchron. Um den Fortschritt des Löschvorgangs zu ermitteln, müssen Sie die DDiscFormat2EraseEvents-Schnittstelle implementieren. Beispiele zum Implementieren eines Ereignishandlers in einem Skript finden Sie unter Überwachen des Fortschritts mit Ereignissen.
Derzeit wird der wert für E_IMAPI_ERASE_TOOK_LONGER_THAN_ONE_HOUR zurückgegeben, wenn der Versuch, eine Löschung auf CD-RW- oder DVD-RW-Medien über die IDiscFormat2Erase-Schnittstelle durchzuführen, aufgrund eines fehlerhaften Mediums oder eines Laufwerksfehlers fehlschlägt.
Anforderungen
| 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 |