In This Topic ▼


#include "ltmm.h"

C Syntax

HRESULT IltmmMediaTypeDisp_get_Format(pMediaTypeDisp, pVal)

C++ Syntax

HRESULT get_Format(pVal)

IltmmMediaTypeDisp *pMediaTypeDisp;

pointer to an interface


pointer to a VARIANT

Gets a direct reference to the format buffer.




Pointer to an IltmmMediaTypeDisp interface.


Pointer to a variable to be updated with a VARIANT containing a SAFEARRAY reference. The array is composed of a single dimension of bytes. This array contains the format information based on the format type.



The function was successful.

<> S_OK

An error occurred. Refer to the Error Codes or the HRESULT error codes in the DirectShow documentation.


This routine will allow direct access to the format buffer for in-process servers. However, if the interface is marshaled across process boundaries, then the client will only be accessing a copy of the data. In such a case, the client should call IltmmMediaTypeDisp::SetFormatData to alter the contents of the format buffer.

The array referenced by pVal cannot be resized. To resize the format buffer, call IltmmMediaTypeDisp::put_FormatSize and then call IltmmMediaTypeDisp::get_Format again.

If the function succeeds, the caller must free the VARIANT referenced by pVal by calling the VariantClear function.


Win32, x64

Help Version 21.0.2021.4.7
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2021 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS Multimedia C API Help