IltmmCaptureSubTypes::Item

#include "ltmm.h"

C Syntax

HRESULT IltmmCaptureSubTypes_Item(pCaptureSubTypes, Index, SubType)

C++ Syntax

HRESULT Item(Index, SubType)

 

IltmmCaptureSubTypes *pCaptureSubTypes;

/*pointer to an interface */

long Index;

/* index */

IltmmCaptureSubType **SubType;

/*pointer to a pointer */

Retrieves the subtype at the specified index.

Parameter

Description

pCaptureSubTypes

Pointer to an IltmmCaptureSubTypes interface.

Index

Index of the subtype to retrieve. This is a zero-based index.

SubType

Pointer to a variable that receives the interface pointer for the subtype at the specified 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

This function will fail if the index is out or range. To find out the number of subtypes, call IltmmCaptureSubTypes::get_Count.

If the function succeeds, the user should release the 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:

IltmmCaptureSubTypes::put_Selection, IltmmCaptureSubTypes::get_Count, IltmmCaptureSubTypes::Find, IltmmCaptureSubTypes::get_Selection

Topics:

Multimedia Function Group

Example

For a C example, refer to the IltmmCaptureSubTypes::get_Count Example for C.

For a C++ example, refer to the IltmmCaptureSubTypes::get_Count Example for C++.