IltmfDevices::Find

Summary

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

Syntax

#include "ltmf.h"

Language Syntax
C HRESULT IltmfDevices_Find(pDevices, Name, Index)
C++ HRESULT Find(Name, Index)

Parameters

IltmfDevices *pDevices

Pointer to an IltmfDevices interface.

BSTR Name

Character string containing the name of the device to find.

long *Index

Pointer to a variable that receives zero based index of the matching device. 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 devices name is unique. An application can use this function to find a specific device. A devices name can be retrieved with the ltmfDevice::get_Name function.

Required DLLs and Libraries

Platforms

Win32, x64.

See Also

Functions

Topics

Example

For an example, refer to Selecting ltmfCapture Object Devices 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.