DD_DXAPI_SET_SURFACE_STATE control code
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)