Fungsi MFTRegisterLocalByCLSID (mfapi.h)

Artikel
03/04/2024

Mendaftarkan transformasi Media Foundation (MFT) dalam proses pemanggil.

Sintaks

HRESULT MFTRegisterLocalByCLSID(
  [in] REFCLSID                     clisdMFT,
  [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] clisdMFT

Pengidentifikasi kelas (CLSID) dari 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.

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

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

MFTRegisterLocal

Fungsi Media Foundation

Bagikan melalui