IltmmCaptureInputs::get_NearestSelection

#include "ltmm.h"

C Syntax

HRESULT IltmmCaptureInputs__get_NearestSelection(pCaptureInputs, pVal)

C++ Syntax

HRESULT get_NearestSelection(pVal)

 

IltmmCaptureInputs *pCaptureInputs;

/* pointer to an interface */

long *pVal;

/* pointer to a variable */

Retrieves the index of the video capture input that was last selected in the video cross bar property page.

Parameter

Description

pCaptureInputs

Pointer to an IltmmCaptureInputs interface.

pVal

Pointer to a variable that receives the zero based index of the last selected video capture input.

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 pVal parameter of the IltmmCaptureInputs::get_Selection function is updated with –1, despite the fact there is a selected input, then the selected video capture input does not match the selected audio input. In this case, call IltmmCaptureInputs::get_NearestSelection to retrieve the index of the last selected capture input. Pass this retrieved index value to the IltmmCaptureInputs::put_Selection function to fix the problem. Please note that if an audio – video pair were mismatched intentionally, it may be best to keep the pair mismatched. For more information on unmatched pairs of video and audio inputs, refer to the IltmmCaptureInputs Interface.

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:

IltmmCaptureInputs::get_Count, IltmmCaptureInputs::get_Selection, IltmmCaptureInputs::put_Selection

Topics:

Multimedia Function Group

Example

For an example, refer to IltmmCaptureInputs::get_NearestSelection Example for C.

For an example, refer to IltmmCaptureInputs::get_NearestSelection Example for C++.