Fungsi MFCreateDeviceSource (mfidl.h)

Artikel
03/15/2023

Membuat sumber media untuk perangkat penangkapan perangkat keras.

Sintaks

HRESULT MFCreateDeviceSource(
  [in]  IMFAttributes  *pAttributes,
  [out] IMFMediaSource **ppSource
);

Parameter

[in] pAttributes

Arahkan ke antarmuka IMFAttributes dari penyimpanan atribut, yang digunakan untuk memilih perangkat. Lihat Keterangan.

[out] ppSource

Menerima penunjuk ke antarmuka IMFMediaSource sumber media. Pemanggil harus merilis antarmuka.

Mengembalikan nilai

Jika fungsi ini berhasil, fungsi akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Penting Ketika perangkat pengambilan tidak lagi diperlukan, Anda harus mematikan perangkat dengan memanggil Matikan pada objek IMFMediaSource yang Anda peroleh dengan memanggil MFCreateDeviceSource. Kegagalan untuk memanggil Matikan dapat mengakibatkan tautan memori karena sistem dapat menyimpan referensi ke sumber daya IMFMediaSource hingga Matikan dipanggil.

Parameter pAttributes menentukan penyimpanan atribut. Untuk membuat penyimpanan atribut, panggil fungsi MFCreateAttributes . Anda harus mengatur atribut MF_DEVSOURCE_ATTRIBUTE_SOURCE_TYPE , yang menentukan jenis perangkat (audio atau video).

Untuk perangkat pengambilan audio, secara opsional atur salah satu atribut berikut:

Atribut	Deskripsi
MF_DEVSOURCE_ATTRIBUTE_SOURCE_TYPE_AUDCAP_ENDPOINT_ID	Menentukan ID titik akhir audio perangkat pengambilan audio.
MF_DEVSOURCE_ATTRIBUTE_SOURCE_TYPE_AUDCAP_ROLE	Menentukan peran perangkat. Jika atribut ini diatur, fungsi menggunakan perangkat pengambilan audio default untuk peran perangkat tersebut. Jangan gabungkan atribut ini dengan atribut MF_DEVSOURCE_ATTRIBUTE_SOURCE_TYPE_AUDCAP_ENDPOINT_ID .

Jika tidak ada atribut yang ditentukan, fungsi memilih perangkat pengambilan audio default untuk peran eCommunications .

Untuk perangkat pengambilan video, Anda harus mengatur atribut berikut:

Atribut	Deskripsi
MF_DEVSOURCE_ATTRIBUTE_SOURCE_TYPE_VIDCAP_SYMBOLIC_LINK	Menentukan tautan simbolis ke perangkat.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 R2 [hanya aplikasi desktop]
Target Platform	Windows
Header	mfidl.h
Pustaka	Mf.lib
DLL	Mf.dll

Lihat juga

Pengambilan Audio/Video di Media Foundation

Mengambil Atribut Perangkat

MFCreateDeviceSourceActivate

Fungsi Media Foundation

Share via