Compartir a través de

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

  • Artículo

El método GetDescriptionData obtiene un bloque de datos de descripción asociado anteriormente a la entrada mediante una llamada a SetDescriptionData.

Sintaxis

HRESULT GetDescriptionData(
  [in, out] DWORD *pdwDescriptionDataSize,
  [out]     BYTE  *pbtDescriptionData,
  [out]     GUID  *pGuidType
);

Parámetros

[in, out] pdwDescriptionDataSize

Si pbtDescriptionData es NULL, se trata de un parámetro de salida que recibe el tamaño, en bytes, del bloque de datos de descripción. Si pbtDescriptionData no es NULL, se trata de un parámetro de entrada que especifica el tamaño, en bytes, del búfer asignado por el autor de la llamada al que apunta pbtDescriptionData.

[out] pbtDescriptionData

NULL, o un puntero a un búfer asignado por el autor de la llamada que, al finalizar correctamente, recibe el bloque de datos de descripción.

[out] pGuidType

Puntero a una variable que recibe un identificador único global (GUID) que identifica el tipo de datos en el bloque de datos de descripción. 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.
MF_E_BUFFERTOOSMALL
 El método devuelve este código de error si pbtDescriptionData no es NULL y el bloque de contexto es mayor que el tamaño especificado por pdwDescriptionDataSize. En ese caso, pdwDescriptionDataSize actúa como parámetro de salida y recibe el tamaño, en bytes, del búfer necesario.

Comentarios

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, al llamar a SetDescriptionData, puede marcar el bloque de datos como de un tipo específico. Al llamar a GetDescriptionData, puede determinar el tipo del bloque de datos recuperado inspeccionando el valor devuelto en pGuidType.

Requisitos

Requisito Value
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

ITocEntry

SetDescriptionData