VC_StreamReset

BOOL
VC_StreamReset(
   VCUSER_HANDLE
vh
   
);

The VC_StreamReset function stops the capture stream, if VC_StreamStop has not been called, and then cancels all queued buffers.

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_StreamReset when its DriverProc function receives a DVM_STREAM_RESET message.

The VC_StreamReset function calls DeviceIoControl (described in the Win32 SDK) to send an IOCTL_VIDC_STREAM_RESET control code to the specified kernel-mode driver. When a kernel-mode driver using VCKernel.lib receives this control code, its StreamStopFunc function is called if the capture stream has not been previously stopped. Then VCKernel.lib returns unused buffers to the user-mode driver. Code in VCUser.lib marks all queued buffers as done by setting VHDR_DONE in the dwFlags member of each buffer’s VIDEOHDR structure, and sends an MM_DRVM_DATA callback message to the client for each buffer.

See Also

VC_StreamStop