ICM_GETSTATE

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

Address of 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.

QuickInfo

  Windows NT: Requires version 3.1 or later.
  Windows: Requires Windows 95 or later.
  Windows CE: Unsupported.
  Header: Declared in vfw.h.

See Also

Video Compression Manager Overview, Video Compression Messages, ICGetState, ICGetStateSize