VC_DrawFrame

BOOL
VC_DrawFrame(
    VCUSER_HANDLE vh,
    PDRAWBUFFER pDraw
    );

The VC_DrawFrame function requests a kernel-mode video capture driver to place video data into the frame buffer so that it can be displayed.

Parameters

vh

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

pDraw

Pointer to a DRAWBUFFER structure.

Return Value

Returns TRUE if the operation succeeds. Otherwise returns FALSE.

Comments

The driver supplies a DRAWBUFFER structure describing the frame to be drawn.

Drivers can call VC_GetOverlayMode to determine if the hardware supports playback of compressed data formats.

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