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

Antarmuka IVMRSurfaceAllocatorNotify

Menggunakan Video Mixing Renderer