HRESULT DirectDrawCreateClipper( DWORD dwFlags,
LPDIRECTDRAWCLIPPER FAR *lplpDDClipper,
IUnknown FAR *pUnkOuter);
Creates an instance of a DirectDrawClipper object not associated with a DirectDraw object.
To create a DirectDrawClipper object owned by a specific DirectDraw object, use the IDirectDraw::CreateClipper method.
·Returns DD_OK if successful, or one of the following error values otherwise:
DDERR_INVALIDPARAMS DDERR_OUTOFMEMORY
dwFlags
This parameter is not currently used and must be set to 0.
lplpDDClipper
Address of a pointer to be filled in with the address of the new DirectDrawClipper object.
pUnkOuter
Allows for future compatibility with COM aggregation features. Presently, however, DirectDrawCreateClipper will return an error if this parameter is anything but NULL.
This function can be called before any DirectDraw objects are created. Because these clippers are not owned by any DirectDraw object, they are not automatically released when an application's objects are released. If not released explicitly by the application, such clippers will be released by DirectDraw when the application terminates.