IltmmTargetDevices::Item

#include "ltmm.h"

C Syntax

HRESULT IltmmTargetDevices_Item(pTargetDevices, Index, TargetDevice)

C++ Syntax

HRESULT Item(Index, TargetDevice)

 

IltmmTargetDevices *pTargetDevices;

/* pointer to an interface */

long Index;

/* index */

IltmmTargetDevice **TargetDevice;

/* pointer to a pointer */

Retrieves the device at the specified index.

Parameter

Description

pTargetDevices

Pointer to an IltmmTargetDevices interface.

Index

Index of the device to be retrieved.

TargetDevice

Pointer to a variable that receives the interface pointer for the device at the specified zero based index.

Returns

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 function succeeds, the user should release the returned interface pointer by calling the interface’s Release method.

Required DLLs and Libraries

LTMM

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

Platforms

Win32, x64

See Also

Elements:

IltmmTargetDevices::get_Count

Topics:

Multimedia Function Group

Example

For a C example, refer to Selecting ltmmCapture Object Target Devices for C and Selecting ltmmConvert Object Target Devices for C.

For a C++ example, refer to Selecting ltmmCapture Object Target Devices for C++ and Selecting ltmmConvert Object Target Devices for C++.