WMVIDEOINFOHEADER2 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 WMVIDEOINFOHEADER2 structure describes the bitmap and color information for a video image, including interlace, copy protection, and aspect ratio.
Syntax
typedef struct tagWMVIDEOINFOHEADER2 {
RECT rcSource;
RECT rcTarget;
DWORD dwBitRate;
DWORD dwBitErrorRate;
LONGLONG AvgTimePerFrame;
DWORD dwInterlaceFlags;
DWORD dwCopyProtectFlags;
DWORD dwPictAspectRatioX;
DWORD dwPictAspectRatioY;
DWORD dwReserved1;
DWORD dwReserved2;
BITMAPINFOHEADER bmiHeader;
} WMVIDEOINFOHEADER2;
Members
rcSource
RECT structure that specifies what part of the source stream should be used to fill the destination buffer. Renderers can use this field to ask the decoders to stretch or clip.
rcTarget
RECT structure that specifies that specifies what part of the destination buffer should be used
dwBitRate
Approximate data rate of the video stream, in bits per second.
dwBitErrorRate
Data error rate of the video stream, in bits per second.
AvgTimePerFrame
The video frame's average display time, in 100-nanosecond units.
dwInterlaceFlags
Bit-wise combination of zero or more flags that describe interlacing behavior. The flags are defined in Dvdmedia.h in the DirectX SDK. Undefined bits must be set to zero or else the connection will be rejected.
dwCopyProtectFlags
Flag set with the AMCOPYPROTECT_RestrictDuplication value (0x00000001) to indicate that the duplication of the stream should be restricted. Undefined bits must be set to zero or else the connection will be rejected.
dwPictAspectRatioX
The X dimension of the video rectangle's aspect ratio. For example, 16 for a 16:9 rectangle.
dwPictAspectRatioY
The Y dimension of the video rectangle's aspect ratio. For example, 9 for a 16:9 rectangle.
dwReserved1
Reserved for future use. Must be zero. (Note: this is different from the corresponding member of the VIDEOINFOHEADER2 structure used in DirectShow.
dwReserved2
Reserved for future use. Must be zero.
bmiHeader
BITMAPINFOHEADER structure that contains color and dimension information for the video image bitmap.
Remarks
This structure is identical to the VIDEOINFOHEADER2 structure defined in Dvdmedia.h. For more information, see the DirectShow documentation in the DirectX SDK.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 2000 Professional [desktop apps only],Windows Media Format 7 SDK, or later versions of the SDK |
| Minimum supported server | Windows 2000 Server [desktop apps only] |
| Header | wmsdkidl.h (include Wmsdk.h) |