Metode IAMDevMemoryAllocator::GetDevMemoryObject (strmif.h)
[Fitur yang terkait dengan halaman ini, DirectShow, adalah fitur warisan. Ini telah digantikan oleh MediaPlayer, IMFMediaEngine, dan Pengambilan Audio/Video di Media Foundation. Fitur-fitur tersebut telah dioptimalkan untuk Windows 10 dan Windows 11. Microsoft sangat menyarankan agar kode baru menggunakan MediaPlayer, IMFMediaEngine , dan Pengambilan Audio/Video di Media Foundation alih-alih DirectShow, jika memungkinkan. Microsoft menyarankan agar kode yang ada yang menggunakan API warisan ditulis ulang untuk menggunakan API baru jika memungkinkan.]
Sintaks
HRESULT GetDevMemoryObject(
[out] IUnknown **ppUnkInnner,
[in] IUnknown *pUnkOuter
);
Parameter
[out] ppUnkInnner
Alamat pointer ke IUnknown objek kontrol yang baru dibuat sendiri. Antarmuka IUnknown dalam ini harus dirilis ketika objek luar dihancurkan. Alokator kustom harus memanggil metode QueryInterface pada pointer ini untuk mendapatkan antarmuka IAMDevMemoryControl .
[in] pUnkOuter
Arahkan ke antarmuka IUnknown alokator kustom sendiri. Antarmuka ini menggabungkan objek kontrol memori perangkat di dalam alokator kustom.
Mengembalikan nilai
Mengembalikan nilai HRESULT .
Keterangan
Objek kontrol memori perangkat diperlukan untuk diagregasi dengan alokator kustom, karena perender yang memerlukan penggunaan memori on-board akan meminta IAMDevMemoryControl ketika mereka menerima alokator baru, untuk memverifikasi bahwa memori berasal dari perangkat yang sama. Ini terjadi karena filter perangkat keras akan menerima objek IMemAllocator , yang mungkin atau mungkin tidak menggunakan memori on-board. Untuk memutuskan apakah itu adalah alokator yang kompatibel, objek akan meminta antarmuka IAMDevMemoryControl untuk mengakses metode tertentu. IAMDevMemoryControl membuat objek agregat yang mengimplementasikan metode IAMDevMemoryControl (ini sering kali khusus perangkat keras).
Lihat dokumentasi COM untuk aturan tentang bagaimana objek luar menerapkan agregasi.
Persyaratan
| Target Platform | Windows |
| Header | strmif.h (termasuk Dshow.h) |