In This Topic ▼

IltmmCaptureInputs::get_NearestSelection

Summary

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

Syntax

#include "ltmm.h"

Language	Syntax
C	HRESULT IltmmCaptureInputs_get_NearestSelection(pCaptureInputs, pVal)
C++	HRESULT get_NearestSelection(pVal)

Parameters

IltmmCaptureInputs *pCaptureInputs

Pointer to an IltmmCaptureInputs interface.

long *pVal

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

Returns

Value	Meaning
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.