ITocEntry::GetDescriptionData method (wmcodecdsp.h)

Metode GetDescriptionData mendapatkan blok data deskripsi yang sebelumnya terkait dengan entri dengan panggilan ke SetDescriptionData.

Sintaks

HRESULT GetDescriptionData(
  [in, out] DWORD *pdwDescriptionDataSize,
  [out]     BYTE  *pbtDescriptionData,
  [out]     GUID  *pGuidType
);

Parameter

[in, out] pdwDescriptionDataSize

Jika pbtDescriptionData adalah NULL, ini adalah parameter output yang menerima ukuran, dalam byte, dari blok data deskripsi. Jika pbtDescriptionData bukan NULL, ini adalah parameter input yang menentukan ukuran, dalam byte, dari buffer yang dialokasikan pemanggil yang dialokasikan yang diarahkan oleh pbtDescriptionData.

[out] pbtDescriptionData

NULL, atau penunjuk ke buffer yang dialokasikan pemanggil yang, setelah berhasil diselesaikan, menerima blok data deskripsi.

[out] pGuidType

Penunjuk ke variabel yang menerima pengidentifikasi unik global (GUID) yang mengidentifikasi jenis data dalam blok data deskripsi. Lihat Keterangan.

Mengembalikan nilai

Metode mengembalikan HRESULT. Nilai yang mungkin termasuk, tetapi tidak terbatas pada, yang ada dalam tabel berikut.

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.
MF_E_BUFFERTOOSMALL	Metode mengembalikan kode kesalahan ini jika pbtDescriptionData bukan NULL dan blok konteks lebih besar dari ukuran yang ditentukan oleh pdwDescriptionDataSize. Dalam hal ini, pdwDescriptionDataSize berfungsi sebagai parameter output dan menerima ukuran, dalam byte, dari buffer yang diperlukan.

Keterangan

Anda hanya dapat mengaitkan satu blok data deskripsi dengan entri tertentu pada waktu tertentu. Namun, Anda mungkin ingin merancang berbagai jenis blok data deskripsi dan mengidentifikasi setiap jenis blok dengan pengidentifikasi unik global (GUID). Dengan demikian, saat memanggil SetDescriptionData, Anda dapat menandai blok data sebagai jenis tertentu. Saat Anda memanggil GetDescriptionData, Anda dapat menentukan jenis blok data yang diambil dengan memeriksa nilai yang dikembalikan dalam pGuidType.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	wmcodecdsp.h
DLL	Wmvdspa.dll

Lihat juga

ITocEntry

SetDescriptionData