Метод ITocEntry::SetDescriptionData (wmcodecdsp.h)

Метод SetDescriptionData связывает блок данных, предоставленный вызывающей стороны, с записью.

Синтаксис

HRESULT SetDescriptionData(
  [in] DWORD dwDescriptionDataSize,
  [in] BYTE  *pbtDescriptionData,
  [in] GUID  *pguidType
);

Параметры

[in] dwDescriptionDataSize

Размер блока данных (в байтах).

[in] pbtDescriptionData

Указатель на первый байт блока данных.

[in] pguidType

Указатель на GUID , определяющий тип данных в блоке. Этот параметр может принимать значение NULL. См. заметки.

Возвращаемое значение

Метод возвращает HRESULT. Допустимые значения включают, но не ограничиваются, значения, приведенные в следующей таблице.

Код возврата	Описание
S_OK	Метод выполнен успешно.

Комментарии

Этот метод можно использовать для связывания любой информации по вашему выбору с записью. Характер данных, храняемых в блоке данных описания, полностью зависит от вас. Средство синтаксического анализа оглавлений не проверяет и не интерпретирует блок данных описания.

Вы можете связать только один блок данных описания с заданной записью в данный момент времени. Однако может потребоваться разработать различные типы блоков данных описания и определить каждый тип блока с помощью глобально уникального идентификатора (GUID). Таким образом, можно связать данные описания определенного типа с некоторыми записями, а данные описания другого типа — с другими записями. Если не нужно различать различные типы блоков данных описания, можно задать для pguidTypeзначение NULL.

Требования

Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Целевая платформа	Windows
Header	wmcodecdsp.h
DLL	Wmvdspa.dll

См. также раздел

GetDescriptionData

ITocEntry