ICGetBuffersWanted macro (vfw.h)

Article
02/22/2024

The ICGetBuffersWanted macro queries a driver for the number of buffers to allocate. You can use this macro or explicitly call the ICM_GETBUFFERSWANTED message.

Syntax

void ICGetBuffersWanted(
   hic,
   lpdwBuffers
);

Parameters

hic

Handle to a driver.

lpdwBuffers

Address to contain the number of samples the driver needs to efficiently render the data.

Return value

None

Remarks

This message is used by drivers that use hardware to render data and want to ensure a minimal time lag caused by waiting for buffers to arrive. For example, if a driver controls a video decompression board that can hold 10 frames of video, it could return 10 for this message. This instructs applications to try to stay 10 frames ahead of the frame it currently needs.

Requirements

Requirement	Value
Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Target Platform	Windows
Header	vfw.h