IWriteEngine2::WriteSection-Methode (imapi2.h)
Schreibt einen Datenstrom in den aktuellen Rekorder.
Syntax
HRESULT WriteSection(
[in] IStream *data,
[in] LONG startingBlockAddress,
[in] LONG numberOfBlocks
);
Parameter
[in] data
Eine IStream-Schnittstelle des Datenstroms, der in den Rekorder geschrieben werden soll.
[in] startingBlockAddress
Starten der logischen Blockadresse (LBA) des Schreibvorgangs. Negative Werte werden unterstützt.
[in] numberOfBlocks
Anzahl der zu schreibenden Blöcke aus dem Datenstrom.
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 |
|
Fehler beim Zuweisen des erforderlichen Arbeitsspeichers.
Wert: 0x8007000E |
|
Mindestens ein Argument ist ungültig.
Wert: 0x80070057 |
|
Die Anforderung wurde abgebrochen.
Wert: 0xC0AA0002 |
Hinweise
Bevor Sie diese Methode aufrufen, müssen Sie die IWriteEngine2::p ut_Recorder-Methode aufrufen, um das Aufzeichnungsgerät und die IWriteEngine2::p ut_BytesPerSector-Methode anzugeben, um die Anzahl der Bytes anzugeben, die während des Schreibens für jeden Sektor verwendet werden sollen.
Sie sollten auch die folgenden Methoden aufrufen, wenn ihre Standardwerte nicht für Ihre Anwendung geeignet sind:
- IWriteEngine2::p ut_EndingSectorsPerSecond
- IWriteEngine2::p ut_StartingSectorsPerSecond
- IWriteEngine2::p ut_UseStreamingWrite12
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 |
Weitere Informationen
IWriteEngine2::get_WriteInProgress