IMediaSample2::Metode GetProperties (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 ini GetProperties
mengambil properti sampel media.
Sintaks
HRESULT GetProperties(
[in] DWORD cbProperties,
[out] BYTE *pbProperties
);
Parameter
[in] cbProperties
Panjang data properti yang akan diambil, dalam byte.
[out] pbProperties
Penunjuk ke buffer ukuran cbProperties.
Mengembalikan nilai
Mengembalikan nilai HRESULT . Nilai yang mungkin termasuk yang berikut ini.
Menampilkan kode | Deskripsi |
---|---|
|
Berhasil. |
|
Argumen pointer NULL. |
Keterangan
Data yang diambil sesuai dengan format struktur AM_SAMPLE2_PROPERTIES . Anda dapat mengambil subset properti sampel dengan mengatur cbProperties ke nilai yang kurang dari ukuran struktur AM_SAMPLE2_PROPERTIES .
Untuk efisiensi, anggota pMediaType yang dikembalikan dalam AM_SAMPLE2_PROPERTIES adalah penunjuk ke data yang disimpan dalam sampel media, bukan salinan data tersebut. Penunjuk mungkin menjadi tidak valid setelah sampel diteruskan ke filter lain, atau setelah metode IMemInputPin::Receive pin input selesai. Selain itu, jangan bebaskan pointer atau hapus jenis media.
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 |