VC_StreamFini

BOOL
VC_StreamFini(
   VCUSER_HANDLE
vh
   );

The VC_StreamFini ends a streaming operation that was initiated by calling VC_StreamInit.

Parameters

vh

Handle to the kernel-mode driver, obtained from VC_OpenDevice.

Return Value

Returns TRUE if the operation succeeds. Otherwise returns FALSE.

Comments

A user-mode video capture driver using VCUser.lib should call VC_StreamFini when its DriverProc function receives a DVM_STREAM_FINI message.

A driver should call the VC_StreamFini function only after it has called VC_StreamStop. The function removes the thread that was created by VC_StreamInit.

The VC_StreamFini function calls DeviceIoControl (described in the Win32 SDK) to send an IOCTL_VIDC_STREAM_RESET control code, followed by an IOCTL_VIDC_STREAM_FINI control code, to the specified kernel-mode driver. When a kernel-mode driver using VCKernel.lib receives the VIDC_STREAM_FINI control code, its StreamFiniFunc function is called.