ICM_GETSTATE

  • Article

The ICM_GETSTATE message queries a video compression driver to return its current configuration in a block of memory or to determine the amount of memory required to retrieve the configuration information. You can send this message explicitly or by using the ICGetState macro.

ICM_GETSTATE 
wParam = (DWORD) (LPVOID) pv; 
lParam = (DWORD) cb;

Parameters

pv

Pointer to a block of memory to contain the current configuration information. You can specify NULL for this parameter to determine the amount of memory required for the configuration information, as in ICGetStateSize.

cb

Size, in bytes, of the block of memory.

Return Values

If pv is NULL, returns the amount of memory, in bytes, required for configuration information.

If pv is not NULL, returns ICERR_OK if successful or an error otherwise.

Remarks

The structure used to represent configuration information is driver specific and is defined by the driver.

Requirements

**  Windows NT/2000/XP:** Included in Windows NT 3.1 and later.
**  Windows 95/98/Me:** Included in Windows 95 and later.
**  Header:** Declared in Vfw.h.

See Also

Video Compression Manager, Video Compression Messages, ICGetState, ICGetStateSize