Partager via


Méthode ITocEntry::SetDescriptionData (wmcodecdsp.h)

La méthode SetDescriptionData associe un bloc de données fourni par l’appelant à l’entrée.

Syntaxe

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

Paramètres

[in] dwDescriptionDataSize

Taille, en octets, du bloc de données.

[in] pbtDescriptionData

Pointeur vers le premier octet du bloc de données.

[in] pguidType

Pointeur vers un GUID qui identifie le type de données dans le bloc. Ce paramètre peut être NULL. Consultez la section Notes.

Valeur de retour

Cette méthode retourne un code HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

Code de retour Description
S_OK
S_OK

Remarques

Vous pouvez utiliser cette méthode pour associer toutes les informations de votre choix à l’entrée. La nature des informations que vous stockez dans le bloc de données de description vous appartient entièrement. L’analyseur TOC n’inspecte ni n’interprète le bloc de données de description.

Vous ne pouvez associer qu’un seul bloc de données de description à une entrée donnée à un moment donné. Toutefois, vous pouvez concevoir différents types de blocs de données de description et identifier chaque type de bloc avec un identificateur global unique (GUID). De cette façon, vous pouvez associer des données de description d’un certain type à certaines de vos entrées et des données de description d’un type différent à d’autres entrées. Si vous n’avez pas besoin de faire la distinction entre différents types de blocs de données de description, vous pouvez définir pguidType sur NULL.

Spécifications

   
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
Plateforme cible Windows
En-tête wmcodecdsp.h
DLL Wmvdspa.dll

Voir aussi

GetDescriptionData

ITocEntry