Fungsi MFStartup (mfapi.h)

Artikel
02/28/2024

Menginisialisasi Microsoft Media Foundation.

Sintaks

HRESULT MFStartup(
  ULONG Version,
  DWORD dwFlags
);

Parameter

Version

Nomor versi. Gunakan nilai MF_VERSION, yang ditentukan dalam mfapi.h.

dwFlags

Parameter ini bersifat opsional saat menggunakan C++ tetapi diperlukan dalam C. Nilai harus berupa salah satu bendera berikut:

Nilai	Makna
MFSTARTUP_NOSOCKET	Jangan menginisialisasi pustaka soket.
MFSTARTUP_LITE	Setara dengan MFSTARTUP_NOSOCKET.
MFSTARTUP_FULL	Menginisialisasi seluruh platform Media Foundation. Ini adalah nilai default ketika dwFlags tidak ditentukan.

Nilai kembali

Fungsi mengembalikan HRESULT. Nilai yang mungkin termasuk, tetapi tidak terbatas pada, yang ada dalam tabel berikut.

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.
MF_E_BAD_STARTUP_VERSION	Parameter Versi memerlukan versi Media Foundation yang lebih baru daripada versi yang sedang berjalan.
MF_E_DISABLED_IN_SAFEMODE	Platform Media Foundation dinonaktifkan karena sistem dimulai dalam "Mode Aman" (boot fail-safe).
E_NOTIMPL	Media Foundation tidak diimplementasikan pada sistem. Kesalahan ini dapat terjadi jika komponen media tidak ada (Lihat KB2703761 untuk informasi selengkapnya).

Keterangan

Aplikasi harus memanggil fungsi ini sebelum menggunakan Media Foundation. Sebelum aplikasi Anda berhenti, panggil MFShutdown sekali untuk setiap panggilan sebelumnya ke MFStartup.

MFStartup harus dipanggil selama harus dipanggil selama inisialisasi aplikasi dan bukan dari konstruktor statis selama inisialisasi proses.

Jangan panggil MFStartup atau MFShutdown dari utas antrean kerja. Untuk informasi selengkapnya tentang antrean kerja, lihat Antrean Kerja.

Fungsi ini tersedia pada platform berikut jika komponen yang dapat didistribusikan ulang Windows Media Format 11 SDK diinstal:

Windows XP dengan Paket Layanan 2 (SP2) dan yang lebih baru.
Windows XP Media Center Edition 2005 dengan KB900325 (Windows XP Media Center Edition 2005) dan KB925766 (Rollup Pembaruan Oktober 2006 untuk Windows XP Media Center Edition) terinstal.

Contoh

    hr = MFStartup(MF_VERSION);

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2008 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	mfapi.h
Pustaka	Mfplat.lib
DLL	Mfplat.dll

Lihat juga

Menginisialisasi Media Foundation

Fungsi Media Foundation

Bagikan melalui