CBaseControlVideo::GetStaticImage
A version of this page is also available for
4/8/2010
A pure virtual method that derived classes override.
Syntax
virtual HRESULT GetStaticImage(
long* pBufferSize,
long* pDIBImage
) PURE;
Parameters
- pBufferSize
Size of the output buffer.
- pDIBImage
Pointer to output buffer.
Return Value
Returns an HRESULT value.
Remarks
Through the IBasicVideo Interface interface, an application can request that it be given a copy of the current image in a memory buffer (some renderers can return E_NOTIMPL to this if they do not support it).
The derived class determines how to retrieve the image. When the application calls CBaseControlVideo::GetStaticImage, it calls this pure virtual method that the derived class should override to implement it. This is also called by the CBaseControlVideo::GetCurrentImage member function.
The class provides a helper member function, CBaseControlVideo::CopyImage, that can be given a sample that contains an image, and the member function will copy the relevant section of it (based on the current source rectangle) into the output buffer supplied by the application.
DirectShow applications and DirectShow filters have different include file and link library requirements.
For more information, see Setting Up the Build Environment.
Requirements
| Windows Embedded CE | Windows CE 2.12 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |
| Note | Microsoft DirectShow applications and DirectShow filters have different include file and Library requirements For more information, see Setting Up the Build Environment, Version 2.12 requires DXPAK 1.0 or later |