Função DirectDrawCreateEx (ddraw.h)

Cria uma instância de um objeto DirectDraw que dá suporte ao conjunto de interfaces Direct3D no DirectX 7.0. Para usar os recursos do Direct3D no DirectX 7.0, crie um objeto DirectDraw com essa função.

Sintaxe

HRESULT DirectDrawCreateEx(
  [in]  GUID     *lpGuid,
  [out] LPVOID   *lplpDD,
  [in]  REFIID   iid,
  [in]  IUnknown *pUnkOuter
);

Parâmetros

[in] lpGuid

Um ponteiro para o GUID (identificador global exclusivo) que representa o driver a ser criado. Isso pode ser NULL para indicar o driver de exibição ativo ou você pode passar um dos seguintes sinalizadores para restringir o comportamento do driver de exibição ativo para fins de depuração:

DDCREATE_EMULATIONONLY

O objeto DirectDraw usa emulação para todos os recursos; ele não aproveita nenhum recurso com suporte de hardware.

DDCREATE_HARDWAREONLY

O objeto DirectDraw nunca emula recursos sem suporte do hardware. As tentativas de chamar métodos que exigem recursos sem suporte falham, retornando DDERR_UNSUPPORTED.

[out] lplpDD

Um ponteiro para uma variável a ser definida como um ponteiro de interface IDirectDraw7 válido se a chamada for bem-sucedida.

[in] iid

Esse parâmetro deve ser definido como IID_IDirectDraw7. Essa função falhará e retornará DDERR_INVALIDPARAMS se qualquer outra interface for especificada.

[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.

Valor retornado

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_DIRECTDRAWALREADYCREATED
• DDERR_GENERIC
• DDERR_INVALIDDIRECTDRAWGUID
• DDERR_INVALIDPARAMS
• DDERR_NODIRECTDRAWHW
• DDERR_OUTOFMEMORY

Comentários

Essa função tenta inicializar um objeto DirectDraw e define um ponteiro para o objeto se a chamada for bem-sucedida.

Em computadores com vários monitores, se você especificar NULL para lpGUID, o objeto DirectDraw será executado no modo de emulação quando o nível cooperativo normal for definido. Para usar a aceleração de hardware nesses computadores, especifique o GUID do dispositivo.

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

Requisitos