Metodo ITocEntry::SetDescriptionData (wmcodecdsp.h)

Il metodo SetDescriptionData associa un blocco di dati fornito dal chiamante alla voce.

Sintassi

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

Parametri

[in] dwDescriptionDataSize

Dimensione, in byte, del blocco di dati.

[in] pbtDescriptionData

Puntatore al primo byte del blocco di dati.

[in] pguidType

Puntatore a un GUID che identifica il tipo di dati nel blocco. Questo parametro può essere NULL. Vedere la sezione Osservazioni.

Valore restituito

Il metodo restituisce un valore HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.

Commenti

È possibile utilizzare questo metodo per associare tutte le informazioni desiderate alla voce. La natura delle informazioni archiviate nel blocco di dati della descrizione dipende completamente dall'utente. Il parser TOC non esamina o interpreta il blocco di dati della descrizione.

È possibile associare un solo blocco di dati di descrizione a una determinata voce in un determinato momento. Tuttavia, è possibile progettare diversi tipi di blocchi di dati di descrizione e identificare ogni tipo di blocco con un identificatore univoco globale (GUID). In questo modo, è possibile associare dati di descrizione di un determinato tipo ad alcune voci e dati di descrizione di un tipo diverso con altre voci. Se non è necessario distinguere tra tipi diversi di blocchi di dati di descrizione, è possibile impostare pguidType su NULL.

Requisiti

Vedi anche

GetDescriptionData

ITocEntry