ITocEntry::SetDescriptionData-Methode (wmcodecdsp.h)

Die SetDescriptionData-Methode ordnet dem Eintrag einen vom Aufrufer bereitgestellten Datenblock zu.

Syntax

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

Parameter

[in] dwDescriptionDataSize

Die Größe des Datenblocks in Bytes.

[in] pbtDescriptionData

Zeiger auf das erste Byte des Datenblocks.

[in] pguidType

Zeiger auf eine GUID , die den Datentyp im Block identifiziert. Dieser Parameter kann NULL sein. Siehe Hinweise.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich ausgeführt.

Hinweise

Sie können diese Methode verwenden, um dem Eintrag beliebige Informationen Ihrer Wahl zuzuordnen. Die Art der Informationen, die Sie im Beschreibungsdatenblock speichern, liegt ganz bei Ihnen. ToC Parser überprüft oder interpretiert den Beschreibungsdatenblock nicht.

Sie können einem bestimmten Eintrag zu einem bestimmten Zeitpunkt nur einen Beschreibungsdatenblock zuordnen. Möglicherweise möchten Sie jedoch verschiedene Arten von Beschreibungsdatenblöcken entwerfen und jeden Blocktyp mit einem global eindeutigen Bezeichner (GUID) identifizieren. Auf diese Weise können Sie Beschreibungsdaten eines bestimmten Typs einigen Einträgen und Beschreibungsdaten eines anderen Typs mit anderen Einträgen zuordnen. Wenn Sie nicht zwischen verschiedenen Typen von Beschreibungsdatenblöcken unterscheiden müssen, können Sie pguidType auf NULL festlegen.

Anforderungen

Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	wmcodecdsp.h
DLL	Wmvdspa.dll

Weitere Informationen

GetDescriptionData

ITocEntry