Fungsi MFCreateTransformActivate (mftransform.h)
Membuat objek aktivasi generik untuk transformasi Media Foundation (MFTs).
Sintaks
HRESULT MFCreateTransformActivate(
[out] IMFActivate **ppActivate
);
Parameter
[out] ppActivate
Menerima penunjuk ke antarmuka IMFActivate . Pemanggil harus merilis antarmuka.
Menampilkan nilai
Jika fungsi ini berhasil, fungsi akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.
Keterangan
Sebagian besar aplikasi tidak akan menggunakan fungsi ini; ini digunakan secara internal oleh fungsi MFTEnumEx .
Objek aktivasi adalah objek pembantu yang membuat objek lain, agak mirip dengan pabrik kelas. Fungsi MFCreateTransformActivate membuat objek aktivasi untuk MFTs. Sebelum objek aktivasi ini dapat membuat MFT, pemanggil harus menginisialisasi objek aktivasi dengan mengatur satu atau beberapa atribut di atasnya.
Atribut | Deskripsi |
---|---|
MFT_TRANSFORM_CLSID_Attribute | Wajib diisi. Berisi CLSID MFT. Objek aktivasi membuat MFT dengan meneruskan CLSID ini ke fungsi CoCreateInstance . |
MF_TRANSFORM_CATEGORY_Attribute | Opsional. Menentukan kategori MFT. |
MF_TRANSFORM_FLAGS_Attribute | Berisi berbagai bendera yang menjelaskan MFT. Untuk MFT berbasis perangkat keras, atur bendera MFT_ENUM_FLAG_HARDWARE . Jika tidak, atribut ini bersifat opsional. |
MFT_CODEC_MERIT_Attribute |
Pilihan. Berisi nilai manfaat codec perangkat keras.
Jika atribut ini diatur dan nilainya lebih besar dari nol, objek aktivasi memanggil MFGetMFTMerit untuk mendapatkan nilai merit tepercaya untuk MFT. Jika merit tepercaya kurang dari nilai atribut ini, metode IMFActivate::ActivateObject objek aktivasi gagal dan mengembalikan MF_E_INVALID_CODEC_MERIT. |
MFT_ENUM_HARDWARE_URL_Attribute | Diperlukan untuk MFTs berbasis perangkat keras. Menentukan tautan simbolis untuk perangkat keras. Proksi perangkat menggunakan nilai ini untuk mengonfigurasi MFT. |
MFT_FIELDOFUSE_UNLOCK_Attribute |
Pilihan. Berisi penunjuk IMFFieldOfUseMFTUnlock , yang dapat digunakan untuk membuka kunci MFT. Antarmuka IMFFieldOfUseMFTUnlock digunakan dengan MFTs yang memiliki batasan penggunaan.
Jika atribut ini diatur dan atribut MF_TRANSFORM_FLAGS_Attribute berisi bendera MFT_ENUM_FLAG_FIELDOFUSE , objek aktivasi memanggil IMFFieldOfUseMFTUnlock::Unlock saat membuat MFT. Aplikasi juga dapat mengatur atribut MFT_FIELDOFUSE_UNLOCK_Attribute tanpa mengatur bendera MFT_ENUM_FLAG_FIELDOFUSE . Dalam hal ini, aplikasi harus memanggil Buka Kunci. |
MFT_PREFERRED_ENCODER_PROFILE |
Pilihan. Berisi profil pengodean untuk encoder. Nilai atribut ini adalah penunjuk IMFAttributes .
Jika atribut ini diatur dan nilai atribut MF_TRANSFORM_CATEGORY_AttributeMFT_CATEGORY_AUDIO_ENCODER atau MFT_CATEGORY_VIDEO_ENCODER, objek aktivasi menggunakan profil pengodean untuk mengonfigurasi MFT. MFT harus mengekspos ICodecAPI atau IPropertyStore untuk tujuan ini. |
MFT_PREFERRED_OUTPUTTYPE_Attribute |
Pilihan. Menentukan format output pilihan untuk encoder.
Jika set atribut ini dan nilai atribut MF_TRANSFORM_CATEGORY_AttributeMFT_CATEGORY_AUDIO_ENCODER atau MFT_CATEGORY_VIDEO_ENCODER, objek aktivasi mengatur jenis media ini pada MFT. |
Untuk informasi selengkapnya tentang objek aktivasi, lihat Objek Aktivasi.
Persyaratan
Klien minimum yang didukung | Windows 7 [hanya aplikasi desktop] |
Server minimum yang didukung | Windows Server 2008 R2 [hanya aplikasi desktop] |
Target Platform | Windows |
Header | mftransform.h |
Pustaka | Mfplat.lib |
DLL | Mfplat.dll |