IVMRSurfaceAllocatorNotify::AdviseSurfaceAllocator method (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.]
Metode AdviseSurfaceAllocator
ini dipanggil oleh aplikasi untuk menginstruksikan VMR untuk menggunakan alokator-presenter kustom.
Sintaks
HRESULT AdviseSurfaceAllocator(
[in] DWORD_PTR dwUserID,
[in] IVMRSurfaceAllocator *lpIVRMSurfaceAllocator
);
Parameter
[in] dwUserID
DWORD_PTR yang ditentukan aplikasi yang secara unik mengidentifikasi instans VMR ini dalam skenario ketika beberapa instans VMR digunakan dengan satu instans penyaji alokator.
[in] lpIVRMSurfaceAllocator
Menentukan antarmuka IVMRSurfaceAllocator pada alokator-presenter baru. Jika nilai ini NULL, maka VMR akan merilis alokator klien-presenter dan memulihkan alokator-presenter defaultnya.
Nilai kembali
Jika metode berhasil, metode akan mengembalikan S_OK. Jika gagal, kode kesalahan akan dikembalikan.
Keterangan
Metode ini akan menyebabkan alokator-presenter default dihapus dan dihancurkan, dan diganti dengan komponen baru yang ditentukan. Komponen baru juga harus mendukung antarmuka IVMRImagePresenter .
Metode ini hanya dapat dipanggil sekali dalam masa pakai VMR. VMR terus menggunakan alokator-presenter sampai VMR itu sendiri dihapus. Ketika VMR akhirnya dirilis, VMR merilis jumlah referensinya pada objek alokator-presenter kustom, yang memungkinkan objek tersebut dibebaskan.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows XP dengan SP1 [hanya aplikasi desktop] |
Server minimum yang didukung | Windows Server 2003 [hanya aplikasi desktop] |
Target Platform | Windows |
Header | strmif.h (termasuk Dshow.h) |
Pustaka | Strmiids.lib |
Lihat juga
Kode Kesalahan dan Keberhasilan