Fungsi MFRegisterLocalSchemeHandler (mfapi.h)

Mendaftarkan handler skema dalam proses pemanggil.

Sintaks

HRESULT MFRegisterLocalSchemeHandler(
  [in] PCWSTR      szScheme,
  [in] IMFActivate *pActivate
);

Parameter

[in] szScheme

String yang berisi skema. Skema ini mencakup karakter ':' berikutnya; misalnya, "http:".

[in] pActivate

Penunjuk ke antarmuka IMFActivate dari objek aktivasi. Pemanggil mengimplementasikan antarmuka ini. Metode IMFActivate::ActivateObject objek aktivasi harus membuat objek handler skema. Handler skema mengekspos antarmuka IMFSchemeHandler .

Nilai kembali

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

Keterangan

Penangan skema digunakan di Microsoft Media Foundation selama proses resolusi sumber, yang membuat sumber media dari URL. Untuk informasi selengkapnya, lihat Penangan Skema dan Penangan Byte-Stream.

Dalam proses, penangan skema lokal lebih diutamakan daripada penangan skema yang terdaftar di registri. Penangan skema lokal tidak terlihat oleh proses lain.

Gunakan fungsi ini jika Anda ingin mendaftarkan handler skema kustom untuk aplikasi Anda, tetapi tidak ingin handler tersedia untuk aplikasi lain.

Persyaratan

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

Lihat juga

MFRegisterLocalByteStreamHandler

Fungsi Media Foundation

Handler skema dan handler Byte-Stream