Метод 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. Допустимые значения включают, но не ограничиваются, значения, приведенные в следующей таблице.
| Код возврата | Описание |
|---|---|
|
Метод выполнен успешно. |
Комментарии
Этот метод можно использовать для связывания любой информации по вашему выбору с записью. Характер данных, храняемых в блоке данных описания, полностью зависит от вас. Средство синтаксического анализа оглавлений не проверяет и не интерпретирует блок данных описания.
Вы можете связать только один блок данных описания с заданной записью в данный момент времени. Однако может потребоваться разработать различные типы блоков данных описания и определить каждый тип блока с помощью глобально уникального идентификатора (GUID). Таким образом, можно связать данные описания определенного типа с некоторыми записями, а данные описания другого типа — с другими записями. Если не нужно различать различные типы блоков данных описания, можно задать для pguidTypeзначение NULL.
Требования
| Минимальная версия клиента | Windows Vista [только классические приложения] |
| Минимальная версия сервера | Windows Server 2008 [только классические приложения] |
| Целевая платформа | Windows |
| Header | wmcodecdsp.h |
| DLL | Wmvdspa.dll |