Bagikan melalui

IWriteEngine2::Metode WriteSection (imapi2.h)

Menulis aliran data ke perekam saat ini.

Sintaks

HRESULT WriteSection(
  [in] IStream *data,
  [in] LONG    startingBlockAddress,
  [in] LONG    numberOfBlocks
);

Parameter

[in] data

Antarmuka IStream aliran data untuk menulis ke perekam.

[in] startingBlockAddress

Memulai alamat blok logis (LBA) dari operasi tulis. Nilai negatif didukung.

[in] numberOfBlocks

Jumlah blok dari aliran data untuk ditulis.

Menampilkan nilai

S_OK dikembalikan pada keberhasilan, tetapi kode keberhasilan lainnya dapat dikembalikan sebagai hasil dari implementasi. Kode kesalahan berikut biasanya dikembalikan pada kegagalan operasi, tetapi tidak mewakili satu-satunya nilai kesalahan yang mungkin:

Menampilkan kode Deskripsi
E_POINTER
 Pointer tidak valid.

Nilai: 0x80004003
E_OUTOFMEMORY
 Gagal mengalokasikan memori yang diperlukan.

Nilai: 0x8007000E
E_INVALIDARG
 Satu atau beberapa argumen tidak valid.

Nilai: 0x80070057
E_IMAPI_REQUEST_CANCELLED
 Permintaan itu dibatalkan.

Nilai: 0xC0AA0002

Keterangan

Sebelum memanggil metode ini, Anda harus memanggil metode IWriteEngine2::p ut_Recorder untuk menentukan perangkat perekaman dan metode IWriteEngine2::p ut_BytesPerSector untuk menentukan jumlah byte yang akan digunakan untuk setiap sektor selama penulisan.

Anda juga harus mempertimbangkan untuk memanggil metode berikut jika nilai defaultnya tidak sesuai untuk aplikasi Anda:

Metode ini sinkron. Untuk menentukan kemajuan operasi tulis, Anda harus mengimplementasikan antarmuka DWriteEngine2Events . Untuk contoh yang menunjukkan cara mengimplementasikan penanganan aktivitas dalam skrip, lihat Memantau Kemajuan Dengan Peristiwa.

Persyaratan

   
Klien minimum yang didukung Windows Vista, Windows XP dengan SP2 [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2003 [hanya aplikasi desktop]
Target Platform Windows
Header imapi2.h

Lihat juga

DWriteEngine2Events

IWriteEngine2

IWriteEngine2::CancelWrite

IWriteEngine2::get_WriteInProgress

IWriteEngine2EventArgs::get_SectorCount

IWriteEngine2EventArgs::get_StartLba

  • Last updated on