Compartilhar via


Método IDirectDrawClipper::GetClipList (ddraw.h)

Recupera uma cópia da lista de clipes associada a um objeto DirectDrawClipper. Para selecionar um subconjunto da lista de clipes, você pode passar um retângulo que corta a lista de clipes.

Sintaxe

HRESULT GetClipList(
  [in]  LPRECT    unnamedParam1,
  [out] LPRGNDATA unnamedParam2,
  [out] LPDWORD   unnamedParam3
);

Parâmetros

[in] unnamedParam1

Um ponteiro para uma estrutura RECT que GetClipList usa para cortar a lista de clipes. Defina esse parâmetro como NULL para recuperar toda a lista de clipes.

[out] unnamedParam2

Um ponteiro para uma estrutura RGNDATA que recebe a cópia resultante da lista de clipes. Se esse parâmetro for NULL, GetClipList preencherá a variável em lpdwSize com o número de bytes necessários para manter toda a lista de clipes.

[out] unnamedParam3

Um ponteiro para uma variável que recebe o tamanho da lista de clipes resultante. Ao recuperar a lista de clipes, esse parâmetro é o tamanho do buffer em lpClipList. Quando lpClipList é NULL, a variável em lpdwSize recebe o tamanho necessário do buffer, em bytes.

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_GENERIC
  • DDERR_INVALIDCLIPLIST
  • DDERR_INVALIDOBJECT
  • DDERR_INVALIDPARAMS
  • DDERR_NOCLIPLIST
  • DDERR_REGIONTOOSMALL

Requisitos

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

Confira também

Idirectdrawclipper