#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. |
See Also
Elements: |
IltmmCaptureInputs::get_Count, IltmmCaptureInputs::get_Selection, IltmmCaptureInputs::put_Selection |
Topics: |
Example
For an example, refer to IltmmCaptureInputs::get_NearestSelection Example for C.
For an example, refer to IltmmCaptureInputs::get_NearestSelection Example for C++.