Fungsi MFCreateDeviceSourceActivate (mfidl.h)

Membuat objek aktivasi yang mewakili perangkat penangkapan perangkat keras.

Sintaks

HRESULT MFCreateDeviceSourceActivate(
  [in]  IMFAttributes *pAttributes,
  [out] IMFActivate   **ppActivate
);

Parameter

[in] pAttributes

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

[out] ppActivate

Menerima penunjuk ke antarmuka IMFActivate . Pemanggil harus merilis antarmuka.

Mengembalikan nilai

Tidak ada

Keterangan

Fungsi ini membuat objek aktivasi yang dapat digunakan untuk membuat sumber media untuk perangkat keras. Untuk membuat sumber media itu sendiri, panggil IMFActivate::ActivateObject.

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

Objek Aktivasi

Pengambilan Audio/Video di Media Foundation

Mengambil Atribut Perangkat

MFCreateDeviceSource

Fungsi Media Foundation