Metode IDiscMaster::EnumDiscRecorders (imapi.h)

Mengambil enumerator untuk semua perekam disk yang didukung oleh format master disk aktif.

Sintaks

HRESULT EnumDiscRecorders(
  [out] IEnumDiscRecorders **ppEnum
);

Parameter

[out] ppEnum

Alamat penunjuk ke enumerator IEnumDiscRecorders .

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:

Keterangan

IEnumDiscRecorders adalah enumerator COM standar, seperti yang didokumenkan dalam IEnumXXXX. Setiap panggilan ke Berikutnya mengembalikan array pointer ke IDiscRecorder. Setiap antarmuka perekam mewakili satu perekam yang tersedia yang sudah terkait dengan perekam disk fisik yang mendasar.

Daftar perekam yang tersedia dapat berubah karena Plug and Play kedatangan atau keberangkatan, atau panggilan ke SetActiveDiscMasterFormat. Aplikasi diberi tahu tentang perubahan ini ketika menerima panggilan ke IDiscMasterProgressEvents::NotifyPnPActivity. Ketika perubahan terjadi, aplikasi harus memanggil metode ini lagi untuk mengambil enumerator baru, karena setiap enumerator berisi rekam jepret perangkat yang didukung pada saat enumerasi.

Saat perangkat dihapus, penunjuk dan antarmuka IDiscRecorder harus tetap valid meskipun perangkat fisik yang mendasar hilang. Dalam hal ini, operasi pada IDiscRecorder atau permintaan untuk merekam disk dapat mengembalikan IMAPI_E_DEVICE_NOTPRESENT.

Properti MaxWriteSpeed diperbarui ketika metode ini dipanggil. Pengaturan default adalah kecepatan tulis tertinggi yang tersedia.

Persyaratan

Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	imapi.h
Pustaka	Uuid.lib
DLL	Actxprxy.dll

Lihat juga

IDiscMaster