IDirectDrawSurface7::UpdateOverlayZOrder
The IDirectDrawSurface7::UpdateOverlayZOrder method sets the z-order of an overlay.
HRESULT UpdateOverlayZOrder(
DWORD dwFlags,
LPDIRECTDRAWSURFACE7 lpDDSReference
);
Parameters
- dwFlags
- One of the following flags:
- DDOVERZ_INSERTINBACKOF
- Inserts this overlay in the overlay chain behind the reference overlay.
- DDOVERZ_INSERTINFRONTOF
- Inserts this overlay in the overlay chain in front of the reference overlay.
- DDOVERZ_MOVEBACKWARD
- Moves this overlay one position backward in the overlay chain.
- DDOVERZ_MOVEFORWARD
- Moves this overlay one position forward in the overlay chain.
- DDOVERZ_SENDTOBACK
- Moves this overlay to the back of the overlay chain.
- DDOVERZ_SENDTOFRONT
- Moves this overlay to the front of the overlay chain.
- lpDDSReference
- Address of the IDirectDrawSurface7 interface for the DirectDraw surface to be used as a relative position in the overlay chain. This parameter is needed only for DDOVERZ_INSERTINBACKOF and DDOVERZ_INSERTINFRONTOF.
Return Values
If the method succeeds, the return value is DD_OK.
If it fails, the method can return one of the following error values:
Windows NT/2000: Requires Windows 2000.
Windows 95/98: Requires Windows 98.
Header: Declared in ddraw.h.
See Also
IDirectDrawSurface7::EnumOverlayZOrders