Partager via

DD_DXAPI_SET_SURFACE_STATE control code

  • Article

A video capture driver passes DD_DXAPI_SET_SURFACE_STATE in the dwFunctionNum parameter of the DxApi function to switch the overlay surface between bob and weave mode.

Input Parameters

  • lpvInBuffer
    Pointer to a DDSETSURFACESTATE structure that contains the requested surface state information.

Output Parameters

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

Remarks

The dwState member of DDSETSURFACESTATE contains the new state, which can be either DDSTATE_BOB or DDSTATE_WEAVE.

If the surface is associated with a hardware video port, it is possible to indicate that you would like the state change to occur at a future time. In this instance, the dwStartField member of DDSETSURFACESTATE indicates the field on which the state change should occur. A value of 0 indicates it should occur at the start of the next field; a value of one indicates the start of the following field, and so on.

This function identifier can be called at raised IRQL.

Requirements

Header file: Ddkmapi.h (include Ddkmapi.h)

See also

DDSETSURFACESTATE