Compartilhar via

Função DirectDrawCreateClipper (ddraw.h)

  • Artigo

Cria uma instância de um objeto DirectDrawClipper que não está associado a um objeto DirectDraw.

Sintaxe

HRESULT DirectDrawCreateClipper(
  [in]  DWORD               dwFlags,
  [out] LPDIRECTDRAWCLIPPER *lplpDDClipper,
  [in]  IUnknown            *pUnkOuter
);

Parâmetros

[in] dwFlags

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

[out] lplpDDClipper

Endereço de um ponteiro a ser preenchido com o endereço do novo objeto DirectDrawClipper.

[in] pUnkOuter

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

Retornar valor

Se a função for bem-sucedida, o valor retornado será DD_OK.

Se falhar, a função poderá retornar um dos seguintes valores de erro:

  • DDERR_INVALIDPARAMS
  • DDERR_OUTOFMEMORY

Comentários

Você pode chamar DirectDrawCreateClipper antes que qualquer objeto DirectDraw seja criado. Como esses objetos DirectDrawClipper não pertencem a nenhum objeto DirectDraw, eles não são liberados automaticamente quando os objetos de um aplicativo são liberados. Se o aplicativo não liberar explicitamente os objetos DirectDrawClipper, o DirectDraw os liberará quando o aplicativo for encerrado.

Para criar um objeto DirectDrawClipper que pertence a um objeto DirectDraw específico, use o método IDirectDraw7::CreateClipper .

Você deve usar LoadLibrary para vincular explicitamente a Ddraw.dll e, em seguida, usar GetProcAddress para acessar a função DirectDrawCreateClipper .

Requisitos

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