IltmfRenderers::Find

Summary

Retrieves the index of the renderer that matches the specified name.

Syntax

#include "ltmf.h"

Language Syntax
C HRESULT IltmfRenderers_Find(pRenderers, name, pVal)
C++ HRESULT Find(name, pVal)

Parameters

IltmfRenderers *pRenderers

Pointer to an IltmfRenderers interface.

BSTR name

Character string containing the name of the renderer to find.

long *pVal

Pointer to a variable that receives a zero based index of the matching renderer. A value of 1 indicates that no match was found.

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 MediaFoundation documentation.

Comments

A renderer's name is unique. An application can use this function to find a specific renderer. A renderers name can be retrieved with the ltmfRenderer::get_Name function.

Required DLLs and Libraries

Platforms

Win32, x64.

See Also

Functions

Topics

Example

For a C++ example, refer to Selecting ltmfCapture Object Renderers for C++.

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

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