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

O método SetDescriptionData associa um bloco de dados fornecido pelo chamador à entrada.

Sintaxe

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

Parâmetros

[in] dwDescriptionDataSize

O tamanho, em bytes, do bloco de dados.

[in] pbtDescriptionData

Ponteiro para o primeiro byte do bloco de dados.

[in] pguidType

Ponteiro para um GUID que identifica o tipo de dados no bloco. Este parâmetro pode ser NULL. Consulte Observações.

Valor retornado

O método retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Comentários

Você pode usar esse método para associar qualquer informação de sua escolha à entrada. A natureza das informações armazenadas no bloco de dados de descrição cabe a você. O Analisador TOC não inspeciona nem interpreta o bloco de dados de descrição.

Você pode associar apenas um bloco de dados de descrição a uma determinada entrada em um determinado momento. No entanto, talvez você queira criar diferentes tipos de blocos de dados de descrição e identificar cada tipo de bloco com um GUID (identificador global exclusivo). Dessa forma, você pode associar dados de descrição de um determinado tipo a algumas de suas entradas e dados de descrição de um tipo diferente com outras entradas. Se você não precisar distinguir entre diferentes tipos de blocos de dados de descrição, poderá definir pguidType como NULL.

Requisitos

Confira também

GetDescriptionData

ITocEntry