Função DirectDrawCreate (ddraw.h)

Cria uma instância de um objeto DirectDraw. Um objeto DirectDraw criado usando essa função não dá suporte ao conjunto completo de interfaces Direct3D no DirectX 7.0. Para criar um objeto DirectDraw capaz de expor todos os recursos do Direct3D no DirectX 7.0, use a função DirectDrawCreateEx .

Sintaxe

HRESULT DirectDrawCreate(
  [in]  GUID         *lpGUID,
  [out] LPDIRECTDRAW *lplpDD,
  [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 para 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 IDirectDraw válido se a chamada for bem-sucedida.

[in] pUnkOuter

Permite compatibilidade futura com recursos de agregação COM. Atualmente, no entanto, essa função retornará um erro se esse parâmetro for algo além de 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_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 DirectDrawCreate .

Requisitos