IltmmDevices::Item

#include "ltmm.h"

C Syntax

HRESULT IltmmDevices_Item(pDevices, Index, Device)

C++ Syntax

HRESULT Item (Index, Device)

 

IltmmDevices *pDevices;

/* pointer to an interface */

long Index;

/* index */

IltmmDevice **Device;

/* pointer to a pointer to an interface */

Retrieves the device at the specified index.

Parameter

Description

pDevices

Pointer to an IltmmDevices interface.

Index

Index of the device to retrieve.

Device

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.

See Also

Elements:

IltmmDevices::get_Count

Topics:

Multimedia Function Group

Example

For an example, refer to Selecting ltmmCapture Object Devices for C.

For an example, refer to Selecting ltmmCapture Object Devices for C++.