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.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.

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

Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	wmcodecdsp.h
DLL	Wmvdspa.dll

Confira também

GetDescriptionData

ITocEntry