IWriteEngine2::Metode WriteSection (imapi2.h)

Artikel
08/24/2023

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