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
方法成功。

注解

可以使用此方法将所选的任何信息与条目相关联。 存储在说明数据块中的信息的性质完全由你决定。 TOC 分析器不检查或解释说明数据块。

在给定时间,只能将一个说明数据块与给定条目相关联。 但是,你可能希望设计不同类型的说明数据块,并使用全局唯一标识符 (GUID) 标识每种类型的块。 这样,可以将特定类型的说明数据与某些条目相关联,将不同类型的说明数据与其他条目相关联。 如果不需要区分不同类型的说明数据块,可以将 pguidType 设置为 NULL

要求

   
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 wmcodecdsp.h
DLL Wmvdspa.dll

另请参阅

GetDescriptionData

ITocEntry