IKsPropertySet::Dapatkan metode (ksproxy.h)

Metode Get mengambil properti yang diidentifikasi oleh GUID set properti dan pengidentifikasi properti.

Sintaksis

HRESULT Get(
  [in]  REFGUID PropSet,
  [in]  ULONG   Id,
  [in]  LPVOID  InstanceData,
  [in]  ULONG   InstanceLength,
  [out] LPVOID  PropertyData,
  [in]  ULONG   DataLength,
  [out] ULONG   *BytesReturned
);

Parameter

[in] PropSet

GUID yang mengidentifikasi kumpulan properti.

[in] Id

Pengidentifikasi properti dalam kumpulan properti.

[in] InstanceData

Penunjuk ke data instans untuk properti .

[in] InstanceLength

Ukuran, dalam byte, buffer di InstanceData.

[out] PropertyData

Penunjuk ke buffer yang menerima nilai properti.

[in] DataLength

Ukuran, dalam byte, buffer di PropertyData.

[out] BytesReturned

Penunjuk ke variabel yang menerima ukuran, dalam byte, dari data yang Dapatkan penyimpanan di buffer di PropertyData.

Mengembalikan nilai

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

Komentar

Untuk mengambil properti, alokasikan buffer, yang Dapatkan isi dengan properti . Untuk menentukan ukuran buffer yang diperlukan, tentukan NULL untuk PropertyData dan nol untuk DataLength . Metode Get mengembalikan ukuran buffer yang diperlukan dalam BytesReturned.

Peringatan

File header ksproxy.h dan dsound.h menentukan versi yang serupa tetapi tidak kompatibel dari antarmuka IKsPropertySet. Aplikasi yang memerlukan modul proksi KS harus menggunakan versi yang ditentukan dalam ksproxy.h. Jika aplikasi harus menyertakan ksproxy.h dan dsound.h, file header mana pun yang dipindai pengkompilasi terlebih dahulu adalah yang definisinya IKsPropertySet digunakan oleh pengkompilasi.

Persyaratan

Syarat	Nilai
Platform Target	Desktop
Header	ksproxy.h (termasuk Ksproxy.h, Dsound.h)

Lihat juga

IKsPropertySet::Set