Metode IKsControl::KsProperty (ksproxy.h)

  • Artikel

Metode KsProperty menetapkan properti atau mengambil informasi properti, bersama dengan operasi dukungan lain yang ditentukan yang tersedia pada kumpulan properti.

Sintaks

HRESULT KsProperty(
  [in]      PKSPROPERTY Property,
  [in]      ULONG       PropertyLength,
  [in, out] LPVOID      PropertyData,
  [in]      ULONG       DataLength,
  [in, out] ULONG       *BytesReturned
);

Parameter

[in] Property

Penunjuk ke struktur yang menjelaskan properti dan jenis permintaan permintaan properti. Struktur ini harus berupa KSPROPERTY atau struktur yang berisi struktur KSPROPERTY sebagai anggota pertamanya. Contoh struktur yang dapat ditujukkan oleh anggota ini adalah struktur KSPROPERTY_VIDEOPROCAMP_S .

[in] PropertyLength

Ukuran, dalam byte, dari buffer di Properti.

[in, out] PropertyData

Penunjuk ke buffer yang berisi data untuk operasi KSPROPERTY_TYPE_SET, KSPROPERTY_TYPE_UNSERIALIZESET, atau KSPROPERTY_TYPE_UNSERIALIZERAW, atau ruang buffer yang menerima data untuk semua operasi lainnya.

[in] DataLength

Ukuran, dalam byte, dari buffer di PropertyData.

[in, out] BytesReturned

Penunjuk ke variabel yang menerima ukuran, dalam byte, dari data yang disimpan KsProperty di buffer di PropertyData. Jika tidak ada data yang disimpan, ukurannya adalah nol.

Mengembalikan nilai

Mengembalikan NOERROR jika berhasil; jika tidak, mengembalikan kode kesalahan.

Keterangan

Untuk menentukan ukuran buffer yang diperlukan untuk permintaan properti tertentu, Anda dapat memanggil metode ini dengan PropertyData diatur ke NULL dan DataLength sama dengan nol. Metode mengembalikan HRESULT_FROM_WIN32(ERROR_MORE_DATA), dan BytesReturned berisi ukuran buffer yang diperlukan.

Persyaratan

Persyaratan Nilai
Target Platform DesktopMobile
Header ksproxy.h (termasuk Ksproxy.h)

Lihat juga

KSPROPERTY

KSPROPERTY_VIDEOPROCAMP_S