Compartilhar via

Método IDirectDrawSurface7::GetAttachedSurface (ddraw.h)

  • Artigo

Obtém a superfície anexada que tem os recursos especificados e incrementa a contagem de referência da interface recuperada.

Sintaxe

HRESULT GetAttachedSurface(
  [in]  LPDDSCAPS2           unnamedParam1,
  [out] LPDIRECTDRAWSURFACE7 *unnamedParam2
);

Parâmetros

[in] unnamedParam1

Um ponteiro para uma estrutura DDSCAPS2 que indica os recursos de hardware da superfície anexada.

[out] unnamedParam2

Um ponteiro para uma variável para receber um ponteiro para a interface IDirectDrawSurface7 da superfície recuperada. A superfície recuperada é aquela que corresponde à descrição, de acordo com o parâmetro lpDDSCaps .

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_NOTFOUND
  • DDERR_SURFACELOST

Comentários

Os anexos são usados para conectar vários objetos DirectDrawSurface em estruturas complexas, como as estruturas complexas necessárias para dar suporte à inversão de página 3D com buffers z. GetAttachedSurface falhará se mais de uma superfície estiver anexada que corresponda aos recursos solicitados. Nesse caso, o aplicativo deve usar o método IDirectDrawSurface7::EnumAttachedSurfaces para obter as superfícies anexadas.

Requisitos

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

Confira também

IDirectDrawSurface7