Fungsi MFTRegisterLocal (mfapi.h)

Artikel
02/28/2024

Mendaftarkan transformasi Media Foundation (MFT) dalam proses pemanggil.

Sintaks

HRESULT MFTRegisterLocal(
  [in] IClassFactory                *pClassFactory,
  [in] REFGUID                      guidCategory,
  [in] LPCWSTR                      pszName,
  [in] UINT32                       Flags,
  [in] UINT32                       cInputTypes,
  [in] const MFT_REGISTER_TYPE_INFO *pInputTypes,
  [in] UINT32                       cOutputTypes,
  [in] const MFT_REGISTER_TYPE_INFO *pOutputTypes
);

Parameter

[in] pClassFactory

Penunjuk ke antarmuka IClassFactory dari objek pabrik kelas. Pabrik kelas membuat MFT.

[in] guidCategory

GUID yang menentukan kategori MFT. Untuk daftar kategori MFT, lihat MFT_CATEGORY.

[in] pszName

String karakter lebar yang dihentikan null yang berisi nama MFT yang mudah diingat.

[in] Flags

Bitwise OR nol atau lebih bendera dari enumerasi _MFT_ENUM_FLAG .

[in] cInputTypes

Jumlah elemen dalam array pInputTypes .

[in] pInputTypes

Penunjuk ke array struktur MFT_REGISTER_TYPE_INFO . Setiap anggota array menentukan format input yang didukung MFT. Parameter ini dapat berupa NULL jika cInputTypes adalah nol.

[in] cOutputTypes

Jumlah elemen dalam array pOutputTypes .

[in] pOutputTypes

Penunjuk ke array struktur MFT_REGISTER_TYPE_INFO . Setiap anggota array menentukan format output yang didukung MFT. Parameter ini dapat berupa NULL jika cOutputTypes adalah nol.

Nilai kembali

Jika fungsi ini berhasil, fungsi akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Tujuan utama dari fungsi ini adalah untuk membuat MFT tersedia untuk resolusi topologi otomatis tanpa membuat MFT tersedia untuk proses atau aplikasi lain.

Setelah Anda memanggil fungsi ini, MFT dapat dijumlahkan dengan memanggil fungsi MFTEnumEx dengan bendera MFT_ENUM_FLAG_LOCALMFT . MFT dapat dijumlahkan dari dalam proses yang sama, tetapi tidak terlihat oleh proses lain.

Parameter pClassFactory menentukan objek pabrik kelas yang membuat MFT. Metode IClassFactory::CreateInstance pabrik kelas harus mengembalikan objek yang mendukung antarmuka IMFTransform .

Catatan Fungsi MFTEnumEx mengambil daftar penunjuk IMFActivate . Namun, pabrik kelas tidak perlu mendukung antarmuka IMFActivate . Sebaliknya, fungsi MFTEnumEx menyediakan implementasi IMFActivate yang membungkus pabrik kelas.

Untuk membatalkan pendaftaran MFT dari proses saat ini, panggil MFTUnregisterLocal.

Jika Anda perlu mendaftarkan MFT dalam proses Jalur Media Terproteksi (PMP), gunakan antarmuka IMFLocalMFTRegistration .

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 R2 [hanya aplikasi desktop]
Target Platform	Windows
Header	mfapi.h
Pustaka	Mfplat.lib
DLL	Mfplat.dll

Lihat juga

MFTRegisterLocalByCLSID

Fungsi Media Foundation

Share via