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

Elements:	IltmmCaptureInputs::get_Count, IltmmCaptureInputs::get_Selection, IltmmCaptureInputs::put_Selection
Topics:	Multimedia Function Group