DD_DXAPI_FLIP_OVERLAY control code

A video capture driver passes DD_DXAPI_FLIP_OVERLAY in the dwFunctionNum parameter of the DxApi function to flip the overlay to display the other surface.

Input Parameters

  • lpvInBuffer
    Pointer to a DDFLIPOVERLAY structure that contains the surface information required for the flip.

Output Parameters

  • lpvOutBuffer
    Pointer to a DWORD that contains the DirectDraw return value.

Remarks

This call does not rotate the memory pointers as does the user-mode DdFlip function, so it is up to the client to keep track of which surface is visible and which is not. The dwFlags member of the DDFLIPOVERLAY structure can contain DDFLIP_EVEN or DDFLIP_ODD to accommodate bob mode when not using a hardware video port. If the overlay is associated with a hardware video port, the hardware video port is not automatically flipped. This function identifier cannot be called while autoflipping.

This function identifier can be called at raised IRQL.

Requirements

Header

Ddkmapi.h (include Ddkmapi.h)

See also

DDFLIPOVERLAY