BOOL
VC_Capture(
VCUSER_HANDLE vh,
BOOL bAcquire
);
The VC_Capture function requests the kernel-mode driver to enable or disable acquisition of video capture data into the frame buffer.
Parameters
vh
Handle to the kernel-mode driver, obtained from VC_OpenDevice.
bAcquire
Set to TRUE to enable capture, or FALSE to disable capture.
Return Value
Returns TRUE if successful. Otherwise returns FALSE.
Comments
User-mode video capture drivers should call VC_Capture with bAcquire set to TRUE when processing a DVM_STREAM_INIT command for the VIDEO_EXTERNALIN channel. They should call the function with bAcquire set to FALSE when processing a DVM_STREAM_FINI command for the VIDEO_EXTERNALIN channel.
Disabling capture when overlay is enabled has the effect of freezing the captured video.
The VC_Capture function calls DeviceIoControl (described in the Win32 SDK) to send either an IOCTL_VIDC_CAPTURE_ON or an IOCTL_VIDC_CAPTURE_OFF control code to the specified kernel-mode driver. When a kernel-mode driver using VCKernel.lib receives one of these control codes, its CaptureFunc function is called.