Fungsi MFBeginCreateFile (mfapi.h)

Artikel
08/24/2023

Memulai permintaan asinkron untuk membuat aliran byte dari file.

Sintaks

HRESULT MFBeginCreateFile(
  [in]  MF_FILE_ACCESSMODE AccessMode,
  [in]  MF_FILE_OPENMODE   OpenMode,
  [in]  MF_FILE_FLAGS      fFlags,
  [in]  LPCWSTR            pwszFilePath,
  [in]  IMFAsyncCallback   *pCallback,
  [in]  IUnknown           *pState,
  [out] IUnknown           **ppCancelCookie
);

Parameter

[in] AccessMode

Mode akses yang diminta, ditentukan sebagai anggota enumerasi MF_FILE_ACCESSMODE .

[in] OpenMode

Perilaku fungsi jika file sudah ada atau tidak ada, ditentukan sebagai anggota enumerasi MF_FILE_OPENMODE .

[in] fFlags

Bitwise ATAU nilai dari enumerasi MF_FILE_FLAGS .

[in] pwszFilePath

Penunjuk ke string yang dihentikan null yang berisi nama file.

[in] pCallback

Arahkan ke antarmuka IMFAsyncCallback dari objek panggilan balik. Pemanggil harus mengimplementasikan antarmuka ini

[in] pState

Penunjuk ke antarmuka IUnknown dari objek status, yang ditentukan oleh pemanggil. Parameter ini bisa NULL. Anda dapat menggunakan objek ini untuk menyimpan informasi status. Objek dikembalikan ke pemanggil ketika panggilan balik dipanggil.

[out] ppCancelCookie

Menerima pointer IUnknown atau nilai NULL. Jika nilainya bukan NULL, Anda dapat membatalkan operasi asinkron dengan meneruskan penunjuk ini ke fungsi MFCancelCreateFile . Pemanggil harus merilis antarmuka. Parameter ini bersifat opsional dan dapat berupa NULL.

Menampilkan nilai

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

Menampilkan kode	Deskripsi
S_OK	Fungsi berhasil.

Keterangan

Ketika permintaan selesai, metode IMFAsyncCallback::Invoke objek panggilan dipanggil. Objek panggilan balik kemudian harus memanggil fungsi MFEndCreateFile untuk mendapatkan penunjuk ke aliran byte.

Persyaratan


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

Lihat juga

Fungsi Media Foundation

Bagikan melalui