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


#include "ltmm.h"

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


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.


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.


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


Win32, x64.

See Also




Language Example
C IltmmCaptureInputs::get_NearestSelection
C++ IltmmCaptureInputs::get_NearestSelection
Help Version 23.0.2024.2.29
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2024 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS Multimedia C API Help

Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.