RESET_MASKS macro (amvideo.h)

[The feature associated with this page, DirectShow, is a legacy feature. It has been superseded by MediaPlayer, IMFMediaEngine, and Audio/Video Capture in Media Foundation. Those features have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer, IMFMediaEngine and Audio/Video Capture in Media Foundation instead of DirectShow, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]

The RESET_MASKS macro fills the color mask fields in a VIDEOINFO structure with zeroes.

Syntax

void RESET_MASKS(
   pbmi
);

Parameters

pbmi

Pointer to a VIDEOINFO structure.

Return value

None

Remarks

As defined in the header file Amvideo.h, this macro is not correct and will cause a compile error. Replace it with the following:


#undef RESET_MASKS
#define RESET_MASKS(x) (ZeroMemory((PVOID)(x)->dwBitMasks, SIZE_MASKS))

Requirements

Requirement Value
Target Platform Windows
Header amvideo.h (include Streams.h)

See also

Video and Image Functions