METODE IMFSourceResolver::BeginCreateObjectFromURL (mfidl.h)

Artikel
08/24/2023

Memulai permintaan asinkron untuk membuat sumber media atau aliran byte dari URL.

Sintaks

HRESULT BeginCreateObjectFromURL(
  [in]  LPCWSTR          pwszURL,
  [in]  DWORD            dwFlags,
  [in]  IPropertyStore   *pProps,
  [out] IUnknown         **ppIUnknownCancelCookie,
  [in]  IMFAsyncCallback *pCallback,
  [in]  IUnknown         *punkState
);

Parameter

[in] pwszURL

String yang dihentikan null yang berisi URL untuk diselesaikan.

[in] dwFlags

Bitwise ATAU bendera. Lihat Bendera Pemecah Masalah Sumber.

[in] pProps

Arahkan ke antarmuka IPropertyStore dari penyimpanan properti. Metode meneruskan penyimpanan properti ke handler skema atau byte-stream handler yang membuat objek. Handler dapat menggunakan penyimpanan properti untuk mengonfigurasi objek. Parameter ini bisa NULL. Untuk informasi selengkapnya, lihat Mengonfigurasi Sumber Media.

[out] ppIUnknownCancelCookie

Menerima pointer IUnknown atau nilai NULL. Jika nilainya bukan NULL, Anda dapat membatalkan operasi asinkron dengan meneruskan pointer ini ke metode IMFSourceResolver::CancelObjectCreation . Pemanggil harus merilis antarmuka. Parameter ini bisa NULL.

[in] pCallback

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

[in] punkState

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.

Mengembalikan nilai

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

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.
MF_E_SOURCERESOLVER_MUTUALLY_EXCLUSIVE_FLAGS	Parameter dwFlags berisi bendera yang saling eksklusif.
MF_E_UNSUPPORTED_SCHEME	Skema URL tidak didukung.

Keterangan

Parameter dwFlags harus berisi bendera MF_RESOLUTION_MEDIASOURCE atau bendera MF_RESOLUTION_BYTESTREAM, tetapi tidak boleh berisi keduanya.

Untuk file lokal, Anda dapat meneruskan nama file di parameter pwszURL ; file: skema tidak diperlukan.

Ketika operasi selesai, pemecah masalah sumber memanggil metode IMFAsyncCallback::Invoke . Metode Invoke harus memanggil IMFSourceResolver::EndCreateObjectFromURL untuk mendapatkan pointer ke objek yang dibuat.

Penggunaan parameter pProps tergantung pada implementasi sumber media.

Persyaratan


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	mfidl.h
Pustaka	Mfuuid.lib

Lihat juga

IMFSourceResolver

Pemecah Masalah Sumber

Share via