Bagikan melalui

Fungsi MFStartup (mfapi.h)

  • Artikel

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