VC_GetKeyColour

DWORD
VC_GetKeyColour(
VCUSER_HANDLE
vh
);

The VC_GetKeyColour function requests a kernel-mode video capture driver to return the device's current key color.

Parameters

vh

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

Return Value

If the hardware supports a key color, the function returns the key color. Otherwise the function returns zero. See the following Comments section.

Comments

Before calling VC_GetKeyColour, the driver should call VC_GetOverlayMode and test the VCO_KEYCOLOUR_RGB flag to determine if, based on the current data format, the kernel-mode driver has stored the key color as an RGB color or as a palette index number. The VC_GetKeyColour function's return value is either an RGBQUAD type or a palette index number, based on the VCO_KEYCOLOUR_RGB flag.

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

See Also

VC_SetKeyColourPalIdx, VC_SetKeyColourRGB