Metode IDiscMaster::SetActiveDiscMasterFormat (imapi.h)

Menyetel format perekam diska yang saat ini aktif. Format aktif menentukan struktur konten file gambar bertahap (audio/data) dan antarmuka COM yang harus digunakan untuk memanipulasi gambar bertahap tersebut.

Sintaks

HRESULT SetActiveDiscMasterFormat(
  [in]  REFIID riid,
  [out] void   **ppUnk
);

Parameter

[in] riid

IID dari format yang saat ini aktif.

[out] ppUnk

Arahkan ke antarmuka COM untuk format disk baru.

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

Panggilan yang berhasil ke metode ini menghapus konten gambar yang saat ini ditahapkan. Selain itu, ini dapat mengubah daftar perekam disk yang didukung. Ini karena tidak semua perekam mendukung semua format. Perubahan pada daftar perekam diumumkan dengan IDiscMasterProgressEvents::NotifyPnPActivity. Jika perekam yang saat ini dipilih bukan anggota set baru perangkat yang didukung, maka tidak akan ada lagi perekam aktif (mirip dengan status setelah panggilan pertama ke Buka). Dalam hal ini, aplikasi harus memilih perekam aktif baru sebelum memulai pembakaran.

MSDiscMasterObj hanya mendukung IID berikut: IID_IRedbookDiscMaster (IRedbookDiscMaster) dan IID_IJolietDiscMaster (IJolietDiscMaster). Jika tidak ada set format, defaultnya adalah format Joliet. Adalah tanggung jawab setiap aplikasi untuk memilih master format melalui penggunaan EnumDiscMasterFormats dan metode ini.

Catatan Panggilan ke metode ini dapat mengubah daftar perekam yang tersedia. Lihat bagian Keterangan enumDiscRecorders untuk informasi selengkapnya.

 

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