Compartilhar via


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

Cria um objeto DirectDrawClipper.

Sintaxe

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

Parâmetros

[in] unnamedParam1

Atualmente, não é usado e deve ser definido como 0.

[out] unnamedParam2

Endereço de uma variável a ser definida como um ponteiro de interface IDirectDrawClipper válido se a chamada for bem-sucedida.

[in] unnamedParam3

Permite a compatibilidade futura com recursos de agregação COM. Atualmente, esse método retornará um erro se esse parâmetro não for NULL.

Retornar valor

Se o método for bem-sucedido, o valor retornado será DD_OK.

Se falhar, o método poderá retornar um dos seguintes valores de erro:

  • DDERR_INVALIDOBJECT
  • DDERR_INVALIDPARAMS
  • DDERR_NOCOOPERATIVELEVELSET
  • DDERR_OUTOFMEMORY

Comentários

O objeto DirectDrawClipper pode ser anexado a um DirectDrawSurface e usado durante as operações IDirectDrawSurface7::Blt, IDirectDrawSurface7::BltBatch e IDirectDrawSurface7::UpdateOverlay .

Para criar um objeto DirectDrawClipper que não pertence a um objeto DirectDraw específico, use a função DirectDrawCreateClipper .

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho ddraw.h
Biblioteca Ddraw.lib
DLL Ddraw.dll

Confira também

IDirectDraw7