IltmmPlay::GetStillPicture

Summary

Retrieves a picture object.

Syntax

#include "ltmm.h"

Language Syntax
C HRESULT IltmmPlay_GetStillPicture(pPlay, TimeOut, ppPicture);
C++ HRESULT GetStillPicture(TimeOut, ppPicture);

Parameters

IltmmPlay *pPlay

Pointer to an IltmmPlay interface.

long TimeOut

Value containing the maximum time, in milliseconds, to wait for the image.

IPictureDisp **ppPicture

Pointer to a variable that receives the picture object's interface pointer.

Returns

Value Meaning
S_OK The function was successful.
<> S_OK An error occurred. Refer to the Error Codes or the HRESULT error codes in the DirectShow documentation.

Comments

If the method succeeds, the caller must free the returned Picture by calling the interface Release method.

If TimeOut is INFINITE, the function's time-out interval never elapses.

Note: The frame data is retrieved from the underlying graph after the processing filters. If the capture needs to occur before the processing is completed use the LeadVideoCallBackFilter and place it first in the collection of processing filters.

Required DLLs and Libraries

Platforms

Win32, x64.

See Also

Functions

Topics

Example

Language Example
C Simple Play Application
C++ Simple Play Application
Help Version 23.0.2024.2.29
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2024 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS Multimedia C API Help
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.