METODE IMFByteStreamHandler::BeginCreateObject (mfidl.h)

Artikel
03/04/2024

Memulai permintaan asinkron untuk membuat sumber media dari aliran byte.

Sintaks

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

Parameter

[in] pByteStream

Arahkan ke antarmuka IMFByteStream aliran byte .

[in] pwszURL

String yang berisi URL asli aliran byte. Parameter ini bisa NULL.

[in] dwFlags

Bitwise OR dari nol atau lebih bendera. Lihat Bendera Pemecah Masalah Sumber.

[in] pProps

Arahkan ke antarmuka IPropertyStore dari penyimpanan properti. Handler byte-stream dapat menggunakan penyimpanan properti ini 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 IMFByteStreamHandler::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.

Nilai kembali

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_CANNOT_PARSE_BYTESTREAM	Tidak dapat mengurai aliran byte.

Keterangan

Parameter dwFlags harus berisi bendera MF_RESOLUTION_MEDIASOURCE dan tidak boleh berisi bendera MF_RESOLUTION_BYTESTREAM.

Handler byte-stream bertanggung jawab untuk mengurai aliran dan memvalidasi konten. Jika aliran tidak valid atau handler aliran byte tidak dapat mengurai aliran, handler harus mengembalikan kode kegagalan. Aliran byte tidak dijamin cocok dengan jenis aliran yang dirancang untuk diurai oleh penghandel byte.

Jika parameter pwszURL bukan NULL, handler byte-stream mungkin menggunakan URL selama proses resolusi. (Misalnya, mungkin menggunakan ekstensi nama file, jika ada.) Selain itu, aliran byte mungkin berisi atribut MF_BYTESTREAM_CONTENT_TYPE , menentukan jenis MIME.

Ketika operasi selesai, handler byte-stream memanggil metode IMFAsyncCallback::Invoke . Metode Panggil harus memanggil IMFByteStreamHandler::EndCreateObject untuk mendapatkan pointer ke sumber media.

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

Lihat juga

IMFByteStreamHandler

Handler skema dan handler Byte-Stream

Bagikan melalui