Método IDirectDraw7::CreateClipper (ddraw.h)

Crea un objeto DirectDrawClipper.

Sintaxis

HRESULT CreateClipper(
  [in]  DWORD               unnamedParam1,
  [out] LPDIRECTDRAWCLIPPER *unnamedParam2,
  [in]  IUnknown            *unnamedParam3
);

Parámetros

[in] unnamedParam1

Actualmente no se usa y debe establecerse en 0.

[out] unnamedParam2

Dirección de una variable que se va a establecer en un puntero de interfaz IDirectDrawClipper válido si la llamada se realiza correctamente.

[in] unnamedParam3

Permite la compatibilidad futura con las características de agregación COM. Actualmente, este método devuelve un error si este parámetro no es NULL.

Valor devuelto

Si el método se realiza correctamente, el valor devuelto se DD_OK.

Si se produce un error, el método puede devolver uno de los siguientes valores de error:

• DDERR_INVALIDOBJECT
• DDERR_INVALIDPARAMS
• DDERR_NOCOOPERATIVELEVELSET
• DDERR_OUTOFMEMORY

Comentarios

El objeto DirectDrawClipper se puede adjuntar a DirectDrawSurface y usarse durante las operaciones IDirectDrawSurface7::Blt, IDirectDrawSurface7::BltBatch e IDirectDrawSurface7::UpdateOverlay .

Para crear un objeto DirectDrawClipper que no sea propiedad de un objeto DirectDraw específico, use la función DirectDrawCreateClipper .

Requisitos

Consulte también

IDirectDraw7