IWMDMMetaData::Metode QueryByName (mswmdm.h)

Artikel
03/05/2024

Metode QueryByName mengambil nilai properti yang ditentukan berdasarkan nama.

Sintaks

HRESULT QueryByName(
  [in]  LPCWSTR           pwszTagName,
  [out] WMDM_TAG_DATATYPE *pType,
  [out] BYTE              **pValue,
  [out] UINT              *pcbLength
);

Parameter

[in] pwszTagName

Penunjuk ke string karakter lebar yang dihentikan null yang menentukan nama properti. Daftar konstanta nama properti standar diberikan dalam Konstanta Metadata.

[out] pType

Nilai WMDM_TAG_DATATYPE yang dijumlahkan yang menjelaskan jenis data yang diambil oleh pValue.

[out] pValue

Arahkan ke penunjuk ke array byte yang menerima konten nilai jika metode berhasil. Windows Media Device Manager mengalokasikan memori ini dan pemanggil harus membebaskannya menggunakan CoTaskMemFree.

[out] pcbLength

Penunjuk ke ukuran, dalam byte, dari array byte ppValue. Jika nilainya adalah string, ini termasuk karakter penghentian.