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

Lihat juga

Objek Aktivasi

Fungsi Media Foundation

Transformasi Media Foundation