Metode IPin::ConnectionMediaType (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 mengambil ConnectionMediaType jenis media untuk koneksi pin saat ini, jika ada.
Sintaks
HRESULT ConnectionMediaType(
[out] AM_MEDIA_TYPE *pmt
);
Parameter
[out] pmt
Penunjuk ke struktur AM_MEDIA_TYPE yang menerima jenis media.
Mengembalikan nilai
Mengembalikan nilai HRESULT . Nilai yang mungkin termasuk yang berikut ini.
| Menampilkan kode | Deskripsi |
|---|---|
|
Berhasil. |
|
Argumen pointer NULL. |
|
Pin tidak tersambung. |
Keterangan
Jika pin tersambung, metode ini menyalin jenis media ke dalam struktur AM_MEDIA_TYPE yang ditentukan oleh pmt. Pemanggil harus membebaskan blok format tipe media. Anda dapat menggunakan fungsi Microsoft® Win32®CoTaskMemFree , atau fungsi pembantu FreeMediaType .
Jika pin tidak tersambung, metode ini akan menghapus jenis media yang ditentukan oleh pmt dan mengembalikan kode kesalahan.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows 2000 Professional [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows 2000 Server [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | strmif.h (termasuk Dshow.h) |
| Pustaka | Strmiids.lib |