Metode IMediaSample2::SetProperties (strmif.h)

[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 SetProperties mengatur properti sampel media.

Sintaks

HRESULT SetProperties(
  [in] DWORD      cbProperties,
  [in] const BYTE *pbProperties
);

Parameter

[in] cbProperties

Panjang data properti yang akan diatur, dalam byte.

[in] 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_INVALIDARG	Argumen tidak valid.
E_OUTOFMEMORY	Memori tidak cukup.
E_POINTER	Argumen penunjuk NULL.

Keterangan

Data yang terkandung dalam struktur AM_SAMPLE2_PROPERTIES . Anda dapat menentukan subset properti sampel dengan mengatur cbProperties ke nilai yang kurang dari ukuran struktur AM_SAMPLE2_PROPERTIES .

Implementasi standar metode ini tidak mendukung pembaruan struktur AM_SAMPLE2_PROPERTIES . Jika anggota ini tidak sama dengan nol, metode mengembalikan E_INVALIDARG. Untuk mengubah data yang terkandung dalam buffer memori sampel, panggil IMediaSample::GetPointer.

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