The DVM_STREAM_FINI message requests a user-mode video capture driver to close a capture stream on a video channel.
Parameters
dwDriverID
Video channel identifier. For this message, the driver should only accept VIDEO_EXTERNALIN, VIDEO_IN, and VIDEO_EXTERNALOUT. (For details, see Opening Video Channels.)
hDriver
Driver handle.
uMsg
DVM_STREAM_FINI
lParam1
Not used.
lParam2
Not used.
Return Value
The driver should return DV_ERR_OK if the operation succeeds. Otherwise, it should return one of the DV_ERR error codes defined in msvideo.h. Custom error codes are also allowed (see DVM_GETERRORTEXT).
Comments
A client sends the DVM_STREAM_FINI message by calling the driver's DriverProc entry point, passing the specified parameter values. Applications can send this message by calling the videoStreamFini function, which is described in the Video for Windows Development Kit.
If all the input buffers sent with DVM_STREAM_ADDBUFFER haven't been returned to the client, the driver should fail the message. If all buffers have been returned, the driver requests the kernel-mode driver to disable the hardware's data capture and overlay operations.
After the driver has finished closing the VIDEO_IN channel, it must send an MM_DRVM_CLOSE callback message.
For more information about video capture streams, see Transferring streams of Captured Data.
User-mode video capture drivers using VCUser.lib can call the following functions to terminate a stream, based on the specified channel.
| Channel | VCUser.lib Function |
| VIDEO_EXTERNALIN | VC_Capture |
| VIDEO_IN | VC_StreamFini |
| VIDEO_EXTERNALOUT | VC_Overlay |
See Also