Partager via


IDirectDrawClipper::GetClipList (Windows Embedded CE 6.0)

1/6/2010

This method retrieves a copy of the clip list associated with a DirectDrawClipper object. A subset of the clip list can be selected by passing a rectangle that clips the clip list.

Syntax

HRESULT GetClipList(
  LPRECT lpRect, 
  LPRGNDATA lpClipList, 
  LPDWORD lpdwSize
); 

Parameters

  • lpRect
    Address of a rectangle that will be used to clip the clip list. This parameter can be NULL to retrieve the entire clip list.
  • lpClipList
    Address of an RGNDATA structure that will contain the resulting copy of the clip list. If this parameter is NULL, the method fills the variable at lpdwSize to the number of bytes necessary to hold the entire clip list.
  • lpdwSize
    Size of the resulting clip list. When retrieving the clip list, this parameter is the size of the buffer at lpClipList. When lpClipList is NULL, the variable at lpdwSize receives the required size of the buffer, in bytes.

Return Value

If the method succeeds, the return value is DD_OK.

If the method fails, the return value may be one of the following error values:

DDERR_GENERIC

DDERR_INVALIDCLIPLIST

DDERR_INVALIDOBJECT

DDERR_INVALIDPARAMS

DDERR_NOCLIPLIST

DDERR_REGIONTOOSMALL

For more information on these error codes see DirectDraw Return Values.

Remarks

The RGNDATA structure used with this method has the following syntax.

typedef struct _RGNDATA { 
  RGNDATAHEADER rdh; 
  char Buffer[1]; 
} RGNDATA;  

The rdh member of the RGNDATA structure is an RGNDATAHEADER structure that has the following syntax.

typedef struct _RGNDATAHEADER { 
  DWORD dwSize; 
  DWORD iType; 
  DWORD nCount; 
  DWORD nRgnSize; 
  RECT rcBound; 
} RGNDATAHEADER;  

For more information about these structures, see the documentation in the Windows SDK.

Requirements

Header ddraw.h
Library ddraw.lib
Windows Embedded CE Windows Embedded CE 6.0 and later

See Also

Reference

IDirectDrawClipper
IDirectDrawClipper::SetClipList