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 |
|---|---|
|
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 |