Funzione DirectDrawCreate (ddraw.h)

Articolo
08/23/2023

Crea un'istanza di un oggetto DirectDraw. Un oggetto DirectDraw creato tramite questa funzione non supporta il set completo di interfacce Direct3D in DirectX 7.0. Per creare un oggetto DirectDraw in grado di esporre tutte le funzionalità di Direct3D in DirectX 7.0, usare la funzione DirectDrawCreateEx .

Sintassi

HRESULT DirectDrawCreate(
  [in]  GUID         *lpGUID,
  [out] LPDIRECTDRAW *lplpDD,
  [in]  IUnknown     *pUnkOuter
);

Parametri

[in] lpGUID

Puntatore all'identificatore univoco globale (GUID) che rappresenta il driver da creare. Può essere NULL per indicare il driver di visualizzazione attivo oppure è possibile passare uno dei flag seguenti per limitare il comportamento del driver di visualizzazione attivo a scopo di debug:

DDCREATE_EMULATIONONLY

L'oggetto DirectDraw usa l'emulazione per tutte le funzionalità; non sfrutta le funzionalità supportate dall'hardware.

DDCREATE_HARDWAREONLY

L'oggetto DirectDraw non emula mai le funzionalità non supportate dall'hardware. I tentativi di chiamare metodi che richiedono funzionalità non supportate hanno esito negativo, restituendo DDERR_UNSUPPORTED.

[out] lplpDD

Puntatore a una variabile da impostare su un puntatore di interfaccia IDirectDraw valido se la chiamata ha esito positivo.

[in] pUnkOuter

Consente la compatibilità futura con le funzionalità di aggregazione COM. Attualmente, tuttavia, questa funzione restituisce un errore se questo parametro è tutt'altro che NULL.

Valore restituito

Se la funzione ha esito positivo, il valore restituito viene DD_OK.

Se ha esito negativo, la funzione può restituire uno dei valori di errore seguenti:

DDERR_DIRECTDRAWALREADYCREATED
DDERR_GENERIC
DDERR_INVALIDDIRECTDRAWGUID
DDERR_INVALIDPARAMS
DDERR_NODIRECTDRAWHW
DDERR_OUTOFMEMORY

Commenti

Questa funzione tenta di inizializzare un oggetto DirectDraw e quindi imposta un puntatore all'oggetto se la chiamata ha esito positivo.

Nei computer con più monitor, se si specifica NULL per lpGUID, l'oggetto DirectDraw viene eseguito in modalità emulazione quando viene impostato il livello cooperativo normale. Per usare l'accelerazione hardware in questi computer, specificare il GUID del dispositivo.

È necessario usare LoadLibrary per collegare in modo esplicito a Ddraw.dll e quindi usare GetProcAddress per accedere alla funzione DirectDrawCreate .

Requisiti

Requisito	Valore
Piattaforma di destinazione	Windows
Intestazione	ddraw.h
Libreria	Ddraw.lib
DLL	Ddraw.dll

Condividi tramite