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

  • Artículo

El método SetDescriptionData asocia un bloque de datos proporcionado por el autor de la llamada a la entrada.

Sintaxis

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

Parámetros

[in] dwDescriptionDataSize

Tamaño, en bytes, del bloque de datos.

[in] pbtDescriptionData

Puntero al primer byte del bloque de datos.

[in] pguidType

Puntero a un GUID que identifica el tipo de datos en el bloque. Este parámetro puede ser NULL. Vea la sección Comentarios.

Valor devuelto

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Código devuelto Descripción
S_OK
 El método se ha llevado a cabo de forma correcta.

Observaciones

Puede usar este método para asociar cualquier información de su elección con la entrada. La naturaleza de la información que se almacena en el bloque de datos de descripción es completamente para usted. ToC Parser no inspecciona ni interpreta el bloque de datos de descripción.

Solo puede asociar un bloque de datos de descripción a una entrada determinada en un momento dado. Sin embargo, es posible que desee diseñar distintos tipos de bloques de datos de descripción e identificar cada tipo de bloque con un identificador único global (GUID). De este modo, puede asociar datos de descripción de un determinado tipo con algunas de sus entradas y datos de descripción de un tipo diferente con otras entradas. Si no necesita distinguir entre distintos tipos de bloques de datos de descripción, puede establecer pguidType en NULL.

Requisitos

   
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado wmcodecdsp.h
Archivo DLL Wmvdspa.dll

Consulte también

GetDescriptionData

ITocEntry