IMFVideoDisplayControl::GetCurrentImage Method
Gets a copy of the current image being displayed by the video renderer.
Syntax
HRESULT GetCurrentImage(
[in, out] BITMAPINFOHEADER *pBih,
[out] BYTE **pDib,
[out] DWORD *pcbDib,
[in, out] LONGLONG *pTimeStamp
);
Parameter
pBih [in, out]
Pointer to a BITMAPINFOHEADER structure that receives a description of the bitmap. Set the biSize member of the structure tosizeof(BITMAPINFOHEADER)before calling the method.pDib [out]
Receives a pointer to a buffer that contains a packed Windows device-independent bitmap (DIB). The caller must free the memory for the bitmap by calling CoTaskMemFree.pcbDib [out]
Receives the size of the buffer returned in pDib, in bytes.pTimeStamp [in, out]
Receives the time stamp of the captured image.
Rückgabewert
The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.
| Rückgabecode | Beschreibung |
|---|---|
| S_OK | The method succeeded. |
| MF_E_LICENSE_INCORRECT_RIGHTS | The content is protected and the license does not permit capturing the image. |
| MF_E_SHUTDOWN | The video renderer has been shut down. |
Hinweise
This method can be called at any time. However, calling the method too frequently degrades the video playback performance.
This method retrieves a copy of the final composited image, which includes any substreams, alpha-blended bitmap, aspect ratio correction, background color, and so forth.
In windowed mode, the bitmap is the size of the destination rectangle specified in IMFVideoDisplayControl::SetVideoPosition. In full-screen mode, the bitmap is the size of the display.
Anforderungen
Mindestens unterstützter Client |
Windows Vista |
Mindestens unterstützter Server |
Windows Server 2008 |
Header |
Evr.h |
Bibliothek |
Strmiids.lib |