WMVIDEOINFOHEADER 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 WMVIDEOINFOHEADER structure describes the bitmap and color information for a video image.

Syntax

typedef struct tagWMVIDEOINFOHEADER {
  RECT             rcSource;
  RECT             rcTarget;
  DWORD            dwBitRate;
  DWORD            dwBitErrorRate;
  LONGLONG         AvgTimePerFrame;
  BITMAPINFOHEADER bmiHeader;
} WMVIDEOINFOHEADER;

Members

rcSource

RECT structure that specifies the source video window.

rcTarget

RECT structure that specifies the destination video window.

dwBitRate

DWORD containing the approximate bit rate, in bits per second.

dwBitErrorRate

DWORD containing the error rate for this stream, in bits per second.

AvgTimePerFrame

When writing an ASF file, this member specifies the desired average time per frame in 100-nanosecond units. When reading an ASF file, this member is always zero.

bmiHeader

BITMAPINFOHEADER structure that contains color and dimension information for the video image bitmap. BITMAPINFOHEADER is a Windows GDI structure.

Remarks

This structure is identical to the DirectShow VIDEOINFOHEADER structure.

For uncompressed video of 16 or fewer bits per pixel (bpp), additional information is required. You must specify bit fields for 16 bpp and palette information for 8 or fewer bpp video. To convey this information, allocate enough consecutive memory to hold the additional information and copy the data to the memory directly following this structure. When you specify the address and size of this structure in the WM_MEDIA_TYPE structure for a stream, include the size of the palette or bit field data.

Requirements