DVM_GETVIDEOAPIVER

The DVM_GETVIDEOAPIVER message requests a user-mode video capture driver to return the version of the video capture API used by the driver.

Parameters

dwDriverID

Video channel identifier. One of VIDEO_EXTERNALIN, VIDEO_IN, VIDEO_OUT, VIDEO_EXTERNALOUT. (For details, see Opening Video Channels.) Can be NULL for this message.

hDriver

Driver handle.

uMsg

DVM_GETVIDEOAPIVER

lParam1

Pointer to a DWORD to receive the version.

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_GETVIDEOAPIVER message by calling the driver’s DriverProc entry point, passing the specified parameter values. Applications can send this message by calling the videoMessage function, which is described in the Video for Windows Development Kit.

The driver should respond to this message by returning the VIDEOAPIVERSION constant in the address pointed to by the lParam1 parameter. The VIDEOAPIVERSION constant is defined in msviddrv.h.