Share via


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