VC_ConfigFormat

BOOL
VC_ConfigFormat(
VCUSER_HANDLE vh,
PCONFIG_INFO pConfig
);

The VC_ConfigFormat function sends format-configuration information to a kernel-mode video capture driver.

Parameters

vh

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

pConfig

Pointer to a CONFIG_INFO structure.

Return Value

Returns TRUE if the operation succeeds. Otherwise returns FALSE.

Comments

User-mode video capture drivers use the VC_ConfigFormat function to send data format parameters to the kernel-mode driver. Typically, a driver calls VC_ConfigFormat when its DriverProc function receives a DVM_FORMAT message, or after it displays a dialog box to allow the user to change the format.

The VC_ConfigFormat function calls DeviceIoControl (described in the Win32 SDK) to send an IOCTL_VIDC_CONFIG_FORMAT control code to the specified kernel-mode driver. When a kernel-mode driver using VCKernel.lib receives this control code, its ConfigFormatFunc function is called.

For more information about changing the video format, see Configuring Video Channels and Setting the Video Data Format.