IKsPropertySet::Dapatkan metode (ksproxy.h)

  • Artikel

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

Sintaks

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

Arahkan ke data instans untuk properti .

[in] InstanceLength

Ukuran, dalam byte, dari buffer di InstanceData.

[out] PropertyData

Penunjuk ke buffer yang menerima nilai properti.

[in] DataLength

Ukuran, dalam byte, dari buffer di PropertyData.

[out] BytesReturned

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

Nilai kembali

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

Keterangan

Untuk mengambil properti, alokasikan buffer, yang Mendapatkan 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 antarmuka IKsPropertySet yang serupa tetapi tidak kompatibel. 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 definisi IKsPropertySet-nya digunakan oleh pengkompilasi.

Persyaratan

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

Lihat juga

IKsPropertySet::Set