Bagikan melalui


Metode IDiscFormat2Data::get_FreeSectorsOnMedia (imapi2.h)

Mengambil jumlah sektor bebas pada disk untuk perekaman inkremental (tanpa menimpa data yang ada).

Catatan Ketika metode ini dipanggil untuk DVD-/+RW, DVD-RAM, dan media BD-RE, nilai sektor bebas yang dilaporkan mewakili kapasitas total, bukan jumlah sektor bebas saat ini. Untuk mengambil sektor gratis untuk jenis media ini, sistem file harus diimpor melalui IFileSystemImage::ImportFileSystem atau IFileSystemImage::ImportSpecificFileSystem, yang akan memungkinkan penggunaan metode IFileSystemImage::get_FreeMediaBlocks untuk mengambil nilai.

 

Sintaks

HRESULT get_FreeSectorsOnMedia(
  [out] LONG *value
);

Parameter

[out] value

Jumlah sektor bebas pada media di perangkat.

Mengembalikan 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_INVALIDARG
Satu atau beberapa argumen tidak valid.

Nilai: 0x80070057

E_POINTER
Pointer tidak valid.

Nilai: 0x80004003

E_FAIL
Kegagalan yang tidak ditentukan.

Nilai: 0x80004005

E_OUTOFMEMORY
Gagal mengalokasikan memori yang diperlukan.

Nilai: 0x8007000E

E_IMAPI_RECORDER_COMMAND_TIMEOUT
Perangkat gagal menerima perintah dalam periode waktu habis. Ini mungkin disebabkan oleh perangkat yang telah memasuki status tidak konsisten, atau nilai batas waktu untuk perintah mungkin perlu ditingkatkan.

Nilai: 0xC0AA020D

E_IMAPI_RECORDER_INVALID_RESPONSE_FROM_DEVICE
Perangkat melaporkan data yang tidak terduga atau tidak valid untuk perintah.

Nilai: 0xC0AA02FF

E_IMAPI_RECORDER_MEDIA_UPSIDE_DOWN
Media dimasukkan terbalik.

Nilai: 0xC0AA0204

E_IMAPI_RECORDER_MEDIA_BECOMING_READY
Drive melaporkan bahwa itu sedang dalam proses menjadi siap. Silakan coba lagi permintaan ini nanti.

Nilai: 0xC0AA0205

E_IMAPI_RECORDER_MEDIA_NO_MEDIA
Tidak ada media di perangkat.

Nilai: 0xC0AA0202

E_IMAPI_RECORDER_MEDIA_FORMAT_IN_PROGRESS
Media saat ini sedang diformat. Harap tunggu hingga format selesai sebelum mencoba menggunakan media.

Nilai: 0xC0AA0206

E_IMAPI_RECORDER_MEDIA_BUSY
Drive melaporkan bahwa drive melakukan operasi jangka panjang, seperti menyelesaikan penulisan. Drive mungkin tidak dapat digunakan untuk jangka waktu yang lama.

Nilai: 0xC0AA0207

E_IMAPI_LOSS_OF_STREAMING
Penulisan gagal karena drive tidak menerima data dengan cukup cepat untuk melanjutkan penulisan. Memindahkan data sumber ke komputer lokal, mengurangi kecepatan tulis, atau mengaktifkan pengaturan "buffer underrun free" dapat mengatasi masalah ini.

Nilai: 0xC0AA0300

E_IMAPI_RECORDER_MEDIA_INCOMPATIBLE
Media tidak kompatibel atau format fisik yang tidak diketahui.

Nilai: 0xC0AA0203

E_IMAPI_RECORDER_DVD_STRUCTURE_NOT_PRESENT
Struktur DVD tidak ada. Ini mungkin disebabkan oleh drive/medium yang tidak kompatibel yang digunakan.

Nilai: 0xC0AA020E

E_IMAPI_RECORDER_NO_SUCH_MODE_PAGE
Perangkat melaporkan bahwa halaman mode yang diminta (dan jenis) tidak ada.

Nilai: 0xC0AA0201

E_IMAPI_RECORDER_INVALID_MODE_PARAMETERS
Drive melaporkan bahwa kombinasi parameter yang disediakan di halaman mode untuk perintah MODE SELECT tidak didukung.

Nilai: 0xC0AA0208

E_IMAPI_RECORDER_MEDIA_WRITE_PROTECTED
Kandar melaporkan bahwa media dilindungi terhadap penulisan.

Nilai: 0xC0AA0209

E_IMAPI_RECORDER_MEDIA_SPEED_MISMATCH
Kecepatan media tidak kompatibel dengan perangkat. Ini mungkin disebabkan oleh penggunaan media kecepatan yang lebih tinggi atau lebih rendah daripada rentang kecepatan yang didukung oleh perangkat.

Nilai: 0xC0AA020F

HRESULT_FROM_WIN32(ERROR_INVALID_HANDLE)
Handel yang ditentukan tidak valid.

Nilai: 6

HRESULT_FROM_WIN32(ERROR_DEV_NOT_EXIST)
Sumber daya atau perangkat jaringan yang ditentukan tidak lagi tersedia.

Nilai: 55

E_IMAPI_RECORDER_LOCKED
Perangkat yang terkait dengan perekam ini selama operasi terakhir telah dikunci secara eksklusif, menyebabkan operasi ini gagal.

Nilai: 0xC0AA0210

E_IMAPI_DF2DATA_INVALID_MEDIA_STATE
Operasi yang diminta hanya valid dengan media yang didukung.

Nilai: 0xC0AA0402

Keterangan

Nilai properti ini secara efektif adalah jumlah sektor yang tersedia pada disk untuk operasi tulis. Nilai memfilter sektor yang dikonsumsi dalam mengelola ruang disk dan kualitas data, seperti blok run-out dan pascagap.

Catatan Untuk disk yang dapat ditimpa, yang hanya memiliki satu sesi fisik, jumlah sektor bebas yang ditunjukkan oleh nilai akan selalu menjadi jumlah total sektor pada disk.
 
Jika IDiscFormat2Data::p ut_ForceOverwrite diatur ke VARIANT_TRUE, gunakan properti IDiscFormat2Data::get_TotalSectorsOnMedia sebagai gantinya.

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

IDiscFormat2Data

IDiscFormat2Data::get_TotalSectorsOnMedia