IltmmDevices::Find

Summary

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

Syntax

#include "ltmm.h"

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

Parameters

IltmmDevices *pDevices

Pointer to an IltmmDevices 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 DirectShow 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 ltmmDevice::get_Name function or by using the LTMM DirectShow Filter List Utility.

Required DLLs and Libraries

Platforms

Win32, x64.

See Also

Functions

Topics

Example

Language Example
C Selecting ltmmCapture Object Devices
C++ Selecting ltmmCapture Object Devices
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.