WM_PICTURE structure (wmsdkidl.h)
[The feature associated with this page, Windows Media Format 11 SDK, is a legacy feature. It has been superseded by Source Reader and Sink Writer. Source Reader and Sink Writer have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use Source Reader and Sink Writer instead of Windows Media Format 11 SDK, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]
The WM_PICTURE structure is used as the data item for the WM/Picture complex metadata attribute.
Syntax
typedef struct _WMPicture {
LPWSTR pwszMIMEType;
BYTE bPictureType;
LPWSTR pwszDescription;
DWORD dwDataLen;
BYTE *pbData;
} WM_PICTURE;
Members
pwszMIMEType
Pointer to a wide-character null-terminated string containing the multipurpose Internet mail extension (MIME) type of the picture.
bPictureType
BYTE value containing one of the following values.
| Value | Description |
|---|---|
| 0 | Picture of a type not specifically listed in this table |
| 1 | 32 pixel by 32 pixel file icon. Use only with portable network graphics (PNG) format |
| 2 | File icon not conforming to type 1 above |
| 3 | Front album cover |
| 4 | Back album cover |
| 5 | Leaflet page |
| 6 | Media. Typically this type of image is of the label side of a CD |
| 7 | Picture of the lead artist, lead performer, or soloist |
| 8 | Picture of one of the artists or performers |
| 9 | Picture of the conductor |
| 10 | Picture of the band or orchestra |
| 11 | Picture of the composer |
| 12 | Picture of the lyricist or writer |
| 13 | Picture of the recording studio or location |
| 14 | Picture taken during a recording session |
| 15 | Picture taken during a performance |
| 16 | Screen capture from a movie or video |
| 17 | A bright colored fish |
| 18 | Illustration |
| 19 | Logo of the band or artist |
| 20 | Logo of the publisher or studio |
pwszDescription
Pointer to a wide-character null-terminated string containing a description of the picture.
dwDataLen
DWORD value containing the size, in bytes, of the picture data pointed to by pbData.
pbData
Pointer to a BYTE array containing the picture data.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 2000 Professional [desktop apps only],Windows Media Format 9 Series SDK, or later versions of the SDK |
| Minimum supported server | Windows 2000 Server [desktop apps only] |
| Header | wmsdkidl.h (include Wmsdk.h) |