Windows Dev Center

Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

ICM_DRAW_SUGGESTFORMAT message

The ICM_DRAW_SUGGESTFORMAT message queries a rendering driver to suggest a decompressed format that it can draw.



ICM_DRAW_SUGGESTFORMAT 
wParam = (DWORD_PTR) (LPVOID) &icdrwSuggest; 
lParam = sizeof(ICDRAWSUGGEST); 


Parameters

icdrwSuggest

Pointer to an ICDRAWSUGGEST structure.

lParam

Size, in bytes, of ICDRAWSUGGEST.

Return Value

Returns ICERR_OK if successful. If the lpbiSuggest member of the ICDRAWSUGGEST structure is NULL, this message returns the amount of memory required to contain the suggested format.

Remarks

The driver should examine the format specified in the lpbiIn member of the ICDRAWSUGGEST structure and use the lpbiSuggest member to return a format it can draw. The output format should preserve as much data as possible from the input format.

Optionally, the driver can use the installable compressor handle passed in the hicDecompressor member of ICDRAWSUGGEST to make more complex selections. For example, if the input format is 24-bit JPEG data, a renderer could query the decompressor to find out if it can decompress to a YUV format (which might be drawn more efficiently) before selecting the format to suggest.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Vfw.h

See also

Video Compression Manager
Video Compression Messages

 

 

Community Additions

Show:
© 2015 Microsoft