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
S_OK	Berhasil.
E_POINTER	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

Lihat juga

Kode Kesalahan dan Keberhasilan

Antarmuka IMediaSample2