Edit

Share via

ASF_FLAT_PICTURE structure (mfidl.h)

  • Article

Contains an image that is stored as metadata for a media source. This structure is used as the data item for the WM/Picture metadata attribute.

Syntax

typedef struct _ASFFlatPicture {
  BYTE  bPictureType;
  DWORD dwDataLen;
} ASF_FLAT_PICTURE;

Members

bPictureType

Specifies the type of image. This member is equivalent to the bPictureType member in the WM_PICTURE structure.

dwDataLen

Size, in bytes, of the image data.

Remarks

The WM/Picture attribute is defined in the Windows Media Format SDK. The attribute contains a picture related to the content, such as album art.

To get this attribute from a media source, call IMFMetadata::GetProperty, passing in the constant g_wszWMPicture for the pwszName parameter. The method retrieves a PROPVARIANT that contains a binary array (VT_BLOB). The layout of the array is as follows:

  • ASF_FLAT_PICTURE structure.
  • Null-terminated wide-character string that contains the MIME type.
  • Null-terminated wide-character string that contains a description.
  • Image data.
This format differs from the WM_PICTURE structure used in the Windows Media Format SDK. The WM_PICTURE structure contains internal pointers to two strings and the image data. If the structure is copied, these pointers become invalid. The ASF_FLAT_PICTURE structure does not contain internal pointers, so it is safe to copy the structure.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Header mfidl.h

See also

IMFMetadata

Media Foundation Structures