IKsPropertySet::Dapatkan metode (dsound.h)

  • Artikel

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

Sintaks

HRESULT Get(
  [in]  REFGUID rguidPropSet,
  [in]  ULONG   ulId,
  [in]  LPVOID  pInstanceData,
  [in]  ULONG   ulInstanceLength,
  [out] LPVOID  pPropertyData,
  [in]  ULONG   ulDataLength,
  [out] PULONG  pulBytesReturned
);

Parameter

[in] rguidPropSet

GUID yang mengidentifikasi kumpulan properti.

[in] ulId

Pengidentifikasi properti dalam kumpulan properti.

[in] pInstanceData

Arahkan ke data instans untuk properti .

[in] ulInstanceLength

Ukuran, dalam byte, dari buffer di InstanceData.

[out] pPropertyData

Penunjuk ke buffer yang menerima nilai properti.

[in] ulDataLength

Ukuran, dalam byte, dari buffer di PropertyData.

[out] pulBytesReturned

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. Versi DirectSound dari IKsPropertySet dijelaskan di halaman referensi DirectSound dalam dokumentasi Microsoft Windows SDK. 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 dsound.h (termasuk Ksproxy.h, Dsound.h)

Lihat juga

IKsPropertySet::Set