Metode CImageAllocator.NotifyMediaType
[Fitur yang terkait dengan halaman ini, DirectShow, adalah fitur warisan. Ini telah digantikan oleh MediaPlayer, IMFMediaEngine, dan Tangkapan 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 Audio/Video Capture 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 ini NotifyMediaType menginformasikan objek jenis media saat ini.
Sintaks
void NotifyMediaType(
CMediaType *pMediaType
);
Parameter
-
pMediaType
-
Arahkan ke objek CMediaType , atau NULL untuk menghapus jenis media.
Nilai kembali
Metode ini tidak mengembalikan nilai.
Keterangan
Filter pemilik harus memanggil metode ini setiap kali jenis media berubah. Biasanya ini terjadi ketika pin pertama kali tersambung, dan setelah perubahan format dinamis. Alokator menggunakan jenis media untuk memvalidasi properti alokator yang diusulkan, dan juga ketika membuat sampel media.
Objek CImageAllocator menyimpan penunjuk pMediaType dalam variabel anggota m_pMediaType . Oleh karena itu, jika pemanggil perlu merilis objek CMediaType , pemanggil harus memperbarui alokator dengan memanggil metode ini lagi, baik dengan pointer baru atau dengan nilai NULL . Jika tidak, kesalahan dapat terjadi ketika alokator mencoba mereferensikan pointer lama.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Header |
|
| Pustaka |
|